/linux-dash

A beautiful web dashboard for Linux

Primary LanguageJavaScriptMIT LicenseMIT


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