linux-dash README

The project's README from github.com/tariqbuilds/linux-dash. As one markdown file: README.md.

v2.0
A simple & low-overhead web dashboard for linux systems

Demo  |  Docs

linux-dash Gitter chat


Features

Installation

Step 1

## 1. clone the repo
git clone --depth 1 https://github.com/afaqurk/linux-dash.git

## 2. go to the cloned directory
cd linux-dash/app/server

OR, if you prefer to download manually:

## 1. Download the .zip
curl -LOk https://github.com/afaqurk/linux-dash/archive/master.zip && unzip master.zip

## 2. navigate to downloaded & unzipped dir
cd linux-dash-master/app/server

Step 2

See instructions for preferred server linux-dash server (all included):

If Using Node.js

## install dependencies
npm install --production

## start linux-dash (on port 80 by default; may require sudo)
## You may change this with the `LINUX_DASH_SERVER_PORT` environment variable (eg. `LINUX_DASH_SERVER_PORT=8080 node server`)
## or provide a --port flag to the command below
## Additionally, the server will listen on every network interface (`0.0.0.0`).
## You may change this with the `LINUX_DASH_SERVER_HOST` environment variable (eg. `LINUX_DASH_SERVER_HOST=127.0.0.1 node server`)
## or provide a --host flag to the command below
node index.js

If Using Go

## start the server (on port 80 by default; may require sudo)
go run index.go

To build a binary, run go build && ./server -h. See @tehbilly's notes here for binary usage options

If Using Python

# Start the server (on port 80 by default; may require sudo).
python index.py

If Using PHP

  1. Make sure you have the exec, shell_exec, and escapeshellarg functions enabled
  2. Point your web server to app/ directory under linux-dash
  3. Restart your web server (Apache, nginx, etc.)

Support

For general help, please use the Gitter chat room.

Security

It is strongly recommended that all linux-dash installations be protected via a security measure of your choice.

Linux Dash does not provide any security or authentication features.

linux-dash (tariqbuilds/linux-dash)

Searching Database…

10.6K ·GitHub
Linux-dash
Что это такое?Linux Dash — это простой веб-дашборд для Linux-машин с минимальной нагрузкой на систему: одна небольшая страница в браузере, которая в реальном времени показывает статистику сервера, на котором он запущен.
Это облачный сервис или мне нужно размещать его самому?Вы размещаете его сами — в проект входят собственные серверные скрипты, которые вы запускаете на Linux-машине, после чего открываете страницу дашборда в браузере.
Как его запустить?Скачайте проект, запустите один из входящих серверных скриптов под свой стек и откройте URL дашборда. В README установка описана как «drop-in» — без дополнительных настроек.
Нужен именно Node.js или подойдёт что-то другое?Подойдёт любой из четырёх стеков — Node.js (рекомендуемый вариант), Go, Python или PHP — соответствующий сервер уже включён в проект, так что выбирайте то, что уже работает на вашей машине.
Есть ли там вход по паролю или разграничение доступа?Нет. В README настоятельно рекомендуется самостоятельно закрыть его своей защитой, потому что в самом Linux Dash никаких средств аутентификации нет.
Насколько он нагружает сервер?Совсем немного — весь проект занимает на диске меньше 400 КБ без папки .git, а низкая нагрузка на систему — одна из его главных особенностей.
Можно ли запустить его на обычном PHP-хостинге, например с Apache?Да — направьте ваш веб-сервер (Apache или nginx) на папку app/, убедитесь, что функции exec, shell_exec и escapeshellarg включены, и перезапустите веб-сервер. В README есть ссылка на инструкцию по настройке PHP + Apache на Digital Ocean.
Дашборд обновляется в реальном времени?Да — сервер на Node.js построен на express и websockets, поэтому статистика приходит в браузер вживую, а не после ручного обновления страницы.
Будет ли он работать на моём Mac или Windows-сервере?Нет — он создан для Linux; разместите его на Linux-машине и открывайте дашборд с любого компьютера, где есть браузер.
What are similar projects?dockge, omnyssh, walle-web, Checkmate, antigravity_phone_chat, Crucix, Profile-Toolkit-for-FSLogix, ZenRift
Which topics is it in?server-monitoring, express, websocket, sysadmin, real-time, dashboard, monitoring, ui, web-app, gui, free, tool
Creator
tariqbuilds
Size
4.6 MB
Stars
10.6K
Updated
CommitMar 22Release2.0May 14
Age
13y
Commits · 90 Days