Skip to content

inacio/linux-dash

 
 

Repository files navigation

Linux Dash

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

DEMO | Installation Instructions | Digital Ocean Tutorial

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 install for PHP (Apache, NGINX), Node.js, and Go

Installation

1. Download Linux Dash

Pick 1 of the following methods to download Linux Dash:

  • Clone the git repo: git clone https://github.com/afaqurk/linux-dash.git
  • Use composer, run composer create-project afaqurk/linux-dash -s dev
  • download the source

2. Secure Linux Dash

It is strongly recommended that all Linux Dash installations be password protected.

3. Start Linux Dash

See the instructions section for the platform of your preference.

Note: All stacks of Linux Dash provide the same functionality. You may switch platforms at any time without any further downloads.

PHP

  1. Make sure you have the exec, shell_exec, and escapeshellarg functions enabled
  2. Restart Apache or nginx

Node.js

  1. Run npm install
  2. Start Linux Dash by running: node server

Go

  1. 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
  • Add info popover UI element for modules
  • Angular tests
  • Back-end tests
    • for shell files
    • for PHP, NodeJS, & Go
  • "Quick Guide to Contributing" Wiki page
  • Add project to package managers
    • npm
    • composer
    • aur
    • apt
  • Bonus:
    • multiple server side languages supported
    • use websockets in PHP & NodeJS

Support

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

About

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

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • CSS 32.4%
  • JavaScript 22.5%
  • Python 21.7%
  • HTML 11.1%
  • Shell 10.8%
  • Go 1.4%
  • PHP 0.1%