A simple & low-overhead web dashboard for linux systems

linux-dash.github.io

Demo  |  Docs

Features

• Small ----- Under 400KB on disk _(with .git removed)!
• Simple --- A minimalist, beautiful dashboard
• Easy ------ Drop-in installation
• Versatile - Choose your stack from Node.js, Go, C, Python, PHP, or Binary

Installation

Step 1

## 1. clone the repo
git clone --depth 1 https://github.com/linux-dash/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):

• Node.js (recommended)
• Go
• Python
• C
• PHP

#### If Using Node.js ```sh ## 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)

node index.js

<br/>
#### If Using Go
```sh
## 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 ```sh # Start the server (on port 80 by default; may require sudo). python index.py ```
#### If Using C ```sh # extract the c server source files tar -jxvf c_server.tar.bz2 -C ./

compile the binary

cd c_server && make

Start the server (on port 80 by default; may require sudo)

./index

<br/>
#### If Using PHP
(TODO: Update PHP instructions with snippets for nginx & apache configs)

1. Make sure you have the `exec`, `shell_exec`, and `escapeshellarg` functions enabled
2. Point your web server to `app/` directory under `linux-dash`
2. Restart your web server (Apache, nginx, etc.)
  - For PHP + Apache setup follow the [Digital Ocean tutorial](https://www.digitalocean.com/community/tutorials/how-to-install-linux-dash-on-ubuntu-14-04).
  - For help with nginx setup, see [this gist](https://gist.github.com/sergeifilippov/8909839) by [@sergeifilippov](https://github.com/sergeifilippov).

## Support

For general help, please use the [Gitter chat room](https://gitter.im/afaqurk/linux-dash).

## 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.