pk-app-linux-dash
v1.2.0
Published
A simple, low overhead web dashboard for linux.
Downloads
2
Maintainers
Readme
pk-app-linux-dash
This is a slight modification version on Linux Dash to make it work on pillakloud system.
For detailed information, please check following messages from original author.
Thanks.
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
- Make sure you have the
exec
,shell_exec
, andescapeshellarg
functions enabled - 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
- [x] Backend ported to ~~Python~~ shell scripts & python from PHP
- [x] Add config file
- [x] Segregate core code-base and modules
- [ ] ~~Each module in a separate directory with front-end template, back-end file, bash script~~
- [ ] 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
- [x] npm
- [x] composer
- [ ] aur
- [ ] apt
- [x] Bonus:
- [x] 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