kryndex / linux-dash

A beautiful web dashboard for Linux

linux-dash

A simple, low-overhead web dashboard for Linux

Demo  |  Features  |  Installation  |  Support

Features

• A beautiful, simple web-based dashboard for monitoring a linux server
• Only ~1MB on disk! (.git removed)
• Live graphs, refresh-able widgets, and a growing # of supported modules
• Drop-in installation for PHP, Node.js, Python, and Go

Installation

Step 1: Download Linux Dash

Clone the git repo

git clone https://github.com/afaqurk/linux-dash.git

Or download it here.

Step 2: Secure Linux Dash

Linux Dash does not provide any security or authentication features.

It is strongly recommended that all Linux Dash installations be protected via a security measure of your choice.

Step 3: Start Linux Dash

Linux Dash can be run in: Node.js, PHP, Go, or Python.
_{* Node.js is the recommended platform since it has native support for websockets and fast I/O.}

First, navigate to the linux-dash folder you downloaded or cloned.

Then, refer to the section for your preferred platform:

Node.js

Install NPM dependencies

npm install

Start Linux Dash

node server/

Default port for Linux Dash is 80. You may change this with the LINUX_DASH_SERVER_PORT environment variable (eg. LINUX_DASH_SERVER_PORT=8080 node server) or editing the server/index.js on line 9

PHP

1. Make sure you have the exec, shell_exec, and escapeshellarg functions enabled
2. Restart your web server (Apache, nginx, etc.)

• For PHP + Apache setup follow the Digital Ocean tutorial.
• For help with nginx setup, see this gist by @sergeifilippov.

Go

Go to the linux-dash/server folder and run

go run index.go

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

Python 2

Run ./python-server.py will run a server on port 80 which is the default. You can provide a specific port via the --port flag.

Support

For help with general setup and configuration issues please use the Linux Dash Gitter chat room.

The following distributions are supported:

• Arch
• Debian 6,7
• Ubuntu 11.04+
• Linux Mint 16+
• CentOS 5, 6
• openSUSE