A beautiful web dashboard for Linux
JavaScript Python Shell CSS HTML Perl Other
Latest commit 9c0ca85 Sep 11, 2016 @afaqurk committed on GitHub Merge pull request #398 from celaus/raid-module
Raid module

README.md


linux-dash

A simple, low-overhead web dashboard for Linux

Check out what's coming in Linux Dash v2.0: in Fall 2016.

Demo  |  Features  |  Installation  |  Support

Linux Dash Gitter chat


Linux Dash screenshot


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 in 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.)


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

Run ./python-server.py will run a server on port 80 which is the default. You can change this in python-server.py on line 43

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