Skip to content

Commit 6f76d95

Browse files
committed
Merge branch 'v2.0'
2 parents f248539 + 00f8a31 commit 6f76d95

File tree

132 files changed

+5024
-4894
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

132 files changed

+5024
-4894
lines changed

.editorconfig

Lines changed: 0 additions & 12 deletions
This file was deleted.

.gitignore

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1-
vendor
21
node_modules
32
*.log
3+
*/linuxDash.min.js.map
4+
temp

README.md

Lines changed: 65 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -1,117 +1,110 @@
1-
<br/>
21
<h1 align="center">
3-
linux-dash
2+
<a href="https://afaqurk.github.io/linux-dash">
3+
<img src="https://raw.githubusercontent.com/afaqurk/screenshots/master/linux-dash/v2.0-logo.png"/>
4+
</a>
45
</h1>
56

67
<p align="center">
7-
A simple, low-overhead web dashboard for Linux
8+
<small>A simple & low-overhead web dashboard for linux systems</small>
89
</p>
910

1011
<p align="center">
11-
<strong>
12-
<a href="http://linuxdash.afaqtariq.com"><i>Demo</i></a> &nbsp;|&nbsp;
13-
<a href="#features"><i>Features</i></a> &nbsp;|&nbsp;
14-
<a href="#installation">
15-
<i>Installation</i></a> &nbsp;|&nbsp;
16-
<a href="#support"><i>Support</i></a>
17-
</strong>
12+
<small>
13+
<a href="https://afaqurk.github.io/linux-dash">Demo</a> &nbsp;|&nbsp;
14+
<a href="https://github.com/afaqurk/linux-dash/wiki">
15+
Docs
16+
</a>
17+
</small>
1818
</p>
1919

20-
<p align="center">
21-
<a href="https://gitter.im/afaqurk/linux-dash">
22-
<img
23-
src="https://badges.gitter.im/gitterHQ/gitter.png"
24-
alt="Linux Dash Gitter chat">
25-
</a>
26-
</p>
2720

28-
<br/>
2921
<p align="center">
30-
<a href="http://linuxdash.afaqtariq.com">
31-
<img
32-
width="80%"
33-
alt="Linux Dash screenshot"
34-
src="http://i.imgur.com/tehGyrQ.gif">
22+
<a href="https://gitter.im/afaqurk/linux-dash">
23+
<img
24+
src="https://badges.gitter.im/gitterHQ/gitter.png"
25+
alt="linux-dash Gitter chat">
3526
</a>
3627
</p>
3728

3829
<br/>
3930

4031
## Features
41-
* A beautiful, simple web-based dashboard for monitoring a linux server
42-
* Only ~1MB on disk! *(.git removed)*
43-
* Live graphs, refresh-able widgets, and a growing # of supported modules
44-
* Drop-in installation for PHP, Node.js, Python, and Go
32+
* **Small** ----- Under 400KB on disk _(with .git removed)!_
33+
* **Simple** ---- A minimalist, beautiful dashboard
34+
* **Easy** ------ Drop-in installation
35+
* **Versatile** -- Choose your stack from Node.js, Go, Python, PHP
4536

4637
## Installation
4738

48-
#### Step 1: Download Linux Dash
49-
50-
Clone the git repo
39+
### Step 1
5140
```sh
52-
git clone https://github.com/afaqurk/linux-dash.git
41+
## 1. clone the repo
42+
git clone --depth 1 https://github.com/afaqurk/linux-dash.git
43+
44+
## 2. go to the cloned directory
45+
cd linux-dash/app/server
46+
5347
```
48+
OR, if you prefer to download manually:
5449

55-
Or download it **[here](https://github.com/afaqurk/linux-dash/archive/master.zip)**.
50+
```sh
51+
## 1. Download the .zip
52+
curl -LOk https://github.com/afaqurk/linux-dash/archive/master.zip && unzip master.zip
5653

57-
#### Step 2: Secure Linux Dash
54+
## 2. navigate to downloaded & unzipped dir
55+
cd linux-dash-master/app/server
5856

59-
Linux Dash does not provide any security or authentication features.
57+
```
6058

61-
**It is strongly recommended** that all Linux Dash installations be protected via a security measure of your choice.
59+
### Step 2
6260

63-
#### Step 3: Start Linux Dash
64-
<h6 align="center">
65-
Linux Dash can be run in: <u>Node.js</u>, PHP, Go, or Python.
66-
<br/>
67-
<sub>
68-
* Node.js is the recommended platform since it has native support for websockets and fast I/O.
69-
</sub>
70-
</h6>
61+
See instructions for preferred server linux-dash server _(all included)_:
7162

72-
First, navigate to the `linux-dash` folder you downloaded or cloned.
63+
* [Node.js](#if-using-nodejs) _(recommended)_
64+
* [Go](#if-using-go)
65+
* [Python](#if-using-python)
66+
* [PHP](#if-using-php)
7367

74-
Then, refer to the section for your preferred platform:
68+
#### If Using Node.js
69+
```sh
70+
## install dependencies
71+
npm install --production
7572

76-
##### Node.js
73+
## start linux-dash (on port 80 by default; may require sudo)
74+
## You may change this with the `LINUX_DASH_SERVER_PORT` environment variable (eg. `LINUX_DASH_SERVER_PORT=8080 node server`)
75+
## or provide a --port flag to the command below
76+
node index.js
7777

78-
Install NPM dependencies
79-
```
80-
npm install
8178
```
8279

83-
Start Linux Dash
80+
#### If Using Go
81+
```sh
82+
## start the server (on port 80 by default; may require sudo)
83+
go run index.go
8484
```
85-
node server/
85+
86+
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
87+
88+
#### If Using Python
89+
```sh
90+
# Start the server (on port 80 by default; may require sudo).
91+
python index.py
8692
```
8793

88-
<small>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](https://github.com/afaqurk/linux-dash/blob/master/server/index.js#L9)</small>
94+
#### If Using PHP
8995

90-
##### PHP
9196
1. Make sure you have the `exec`, `shell_exec`, and `escapeshellarg` functions enabled
92-
2. Restart your web server (Apache, nginx, etc.)
97+
2. Point your web server to `app/` directory under `linux-dash`
98+
2. Restart your web server (Apache, nginx, etc.)
9399
- For PHP + Apache setup follow the [Digital Ocean tutorial](https://www.digitalocean.com/community/tutorials/how-to-install-linux-dash-on-ubuntu-14-04).
94100
- For help with nginx setup, see [this gist](https://gist.github.com/sergeifilippov/8909839) by [@sergeifilippov](https://github.com/sergeifilippov).
95101

96-
##### Go
97-
Go to the `linux-dash/server` folder and run
98-
```
99-
go run index.go
100-
```
101-
102-
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
102+
## Support
103103

104-
##### Python 2
105-
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.
104+
For general help, please use the [Gitter chat room](https://gitter.im/afaqurk/linux-dash).
106105

107-
## Support
106+
## Security
108107

109-
For help with general setup and configuration issues please use the [Linux Dash Gitter chat room](https://gitter.im/afaqurk/linux-dash).
108+
**It is strongly recommended** that all linux-dash installations be protected via a security measure of your choice.
110109

111-
The following distributions are supported:
112-
* Arch
113-
* Debian 6,7
114-
* Ubuntu 11.04+
115-
* Linux Mint 16+
116-
* CentOS 5, 6
117-
* openSUSE
110+
linux-dash does not provide any security or authentication features.

app/index.html

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
<!DOCTYPE html>
2+
<html lang="en" ng-app="linuxDash">
3+
<head>
4+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5+
<title>Linux Dash : Simple, beautiful server monitoring web dashboard</title>
6+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
7+
<meta name="description" content="Monitor your Linux server through a simple web dashboard. Open source and free!">
8+
<meta name="apple-mobile-web-app-capable" content="yes">
9+
<link href='//fonts.googleapis.com/css?family=Merriweather:300italic,300|Open+Sans:400,600' rel='stylesheet' type='text/css'>
10+
<link href='linuxDash.min.css' rel='stylesheet' type='text/css'>
11+
12+
<!-- Le HTML5 shim, for IE6-8 support of HTML5 elements -->
13+
<!--[if lt IE 9]>
14+
<script src="https://html5shim.googlecode.com/svn/trunk/html5.js"></script>
15+
<![endif]-->
16+
</head>
17+
<body>
18+
19+
<nav-bar></nav-bar>
20+
21+
<!-- Templates Get Rendered Here -->
22+
<div id="plugins" ng-view></div>
23+
24+
<!-- Javascript-->
25+
<script src="linuxDash.min.js" type="text/javascript"></script>
26+
</body>
27+
</html>

app/linuxDash.min.css

Lines changed: 10 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)