Skip to content

Kryndex/linux-dash

 
 

Repository files navigation


linux-dash

A simple, low-overhead web dashboard for Linux

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

About

A beautiful web dashboard for Linux

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 32.1%
  • Python 22.2%
  • Shell 15.4%
  • CSS 13.9%
  • HTML 11.6%
  • Perl 3.3%
  • Other 1.5%