Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tariqbuilds/linux-dash
A beautiful web dashboard for Linux
https://github.com/tariqbuilds/linux-dash
dashboard linux linux-dash monitoring server ui web
Last synced: 6 days ago
JSON representation
A beautiful web dashboard for Linux
- Host: GitHub
- URL: https://github.com/tariqbuilds/linux-dash
- Owner: tariqbuilds
- License: mit
- Created: 2013-10-16T14:58:47.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-04-16T18:08:58.000Z (9 months ago)
- Last Synced: 2025-01-01T18:08:04.716Z (13 days ago)
- Topics: dashboard, linux, linux-dash, monitoring, server, ui, web
- Language: JavaScript
- Homepage: https://afaqurk.github.io/linux-dash/
- Size: 4.48 MB
- Stars: 10,435
- Watchers: 343
- Forks: 1,203
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome - tariqbuilds/linux-dash - A beautiful web dashboard for Linux (JavaScript)
- project-awesome - tariqbuilds/linux-dash - A beautiful web dashboard for Linux (JavaScript)
- StarryDivineSky - tariqbuilds/linux-dash
- stars - linux-dash
- stars - linux-dash
- awesome-starred - tariqbuilds/linux-dash - A beautiful web dashboard for Linux (web)
README
v2.0
A simple & low-overhead web dashboard for linux systems
## Features
* **Small** ----- Under 400KB on disk _(with .git removed)!_
* **Simple** ---- A minimalist, beautiful dashboard
* **Easy** ------ Drop-in installation
* **Versatile** -- Choose your stack from Node.js, Go, Python, PHP
## Installation
### Step 1
```sh
## 1. clone the repo
git clone --depth 1 https://github.com/afaqurk/linux-dash.git
## 2. go to the cloned directory
cd linux-dash/app/server
```
OR, if you prefer to download manually:
```sh
## 1. Download the .zip
curl -LOk https://github.com/afaqurk/linux-dash/archive/master.zip && unzip master.zip
## 2. navigate to downloaded & unzipped dir
cd linux-dash-master/app/server
```
### Step 2
See instructions for preferred server linux-dash server _(all included)_:
* [Node.js](#if-using-nodejs) _(recommended)_
* [Go](#if-using-go)
* [Python](#if-using-python)
* [PHP](#if-using-php)
#### If Using Node.js
```sh
## install dependencies
npm install --production
## start linux-dash (on port 80 by default; may require sudo)
## You may change this with the `LINUX_DASH_SERVER_PORT` environment variable (eg. `LINUX_DASH_SERVER_PORT=8080 node server`)
## or provide a --port flag to the command below
## Additionally, the server will listen on every network interface (`0.0.0.0`).
## You may change this with the `LINUX_DASH_SERVER_HOST` environment variable (eg. `LINUX_DASH_SERVER_HOST=127.0.0.1 node server`)
## or provide a --host flag to the command below
node index.js
```
#### If Using Go
```sh
## start the server (on port 80 by default; may require sudo)
go run index.go
```
To build a binary, run `go build && ./server -h`. See [@tehbilly](https://github.com/sergeifilippov)'s notes [here](https://github.com/afaqurk/linux-dash/pull/281) for binary usage options
#### If Using Python
```sh
# Start the server (on port 80 by default; may require sudo).
python index.py
```
#### If Using PHP
1. Make sure you have the `exec`, `shell_exec`, and `escapeshellarg` functions enabled
2. Point your web server to `app/` directory under `linux-dash`
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).
## Support
For general help, please use the [Gitter chat room](https://gitter.im/afaqurk/linux-dash).
## Security
**It is strongly recommended** that all linux-dash installations be protected via a security measure of your choice.
Linux Dash does not provide any security or authentication features.