mynicolas/linux-dash

A drop-in, low-overhead monitoring web dashboard for a linux machine.

Linux Dash

A simple, low-overhead web dashboard for GNU / Linux. (~1MB)

DEMO | Installation Instructions | 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

1. Download Linux Dash

Clone the git repo:

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

Alternatives:

• Install the Composer package

composer create-project afaqurk/linux-dash -s dev

• Download the source at: https://github.com/afaqurk/linux-dash/archive/master.zip

2. Secure Linux Dash

It is strongly recommended that all Linux Dash installations be password protected. Please add htaccess protection or another security measure of your choice.

3. Start Linux Dash

See the section for your platform.

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.

Node.js

Install NPM dependencies

npm install

Start Linux Dash

node server

• Default port is 80. You may change this in server/index.js on line 8

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

Goals for v2.0

• Backend ported to Python shell scripts & python from PHP
• Add config file
• Segregate core code-base and modules
• Each module in a separate directory with front-end template, back-end file, bash script Doesn't make sense in implementation.
• Add angular element to show info section for a module
• Angular tests
• Back-end tests
  • for shell files
  • for PHP, NodeJS, & Go
• "Quick Guide to Contributing" Wiki page
• Add project to package managers
  • aur
  • apt (ubuntu)
• Bonus:
  • multiple server side languages supported
  • use websockets in PHP & NodeJS

Support

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

The following categories are targeted by the Linux Dash project:

• OS
• Arch
• Debian 6,7
• Ubuntu 11.04+
• Linux Mint 16+
• CentOS 5, 6
• Backend
• Node.js
• Go
• PHP 5