added linux-step-by-step.md

This commit is contained in:
dg9vh 2016-05-07 20:56:25 +02:00
parent fe53e12160
commit 8844c1c420

57
linux-step-by-step.md Normal file
View file

@ -0,0 +1,57 @@
# Linux Step-By-Step
This short howto describes step-by-step how to install the MMDVMHost-Dashboard on a Raspberry Pi (or similar) System using a Debian-Linux Distribution like Raspbian.
##Installation Steps
1. Actualize your Liux-system and package sources with the following command:
>sudo apt-get update && sudo apt-get upgrade
2. Install a tiny webserver with
>sudo apt-get install lighttpd
3. Now it's time to modify file-system-rights. Following steps would do it for you:
>sudo groupadd www-data
>sudo usermod -G www-data -a pi
If you use a current Raspbian Jessie, use following commands:
>sudo chown -R www-data:www-data /var/www/html
>sudo chmod -R 775 /var/www/html
If you use a Raspian Wheezy use:
>sudo chown -R www-data:www-data /var/www
>sudo chmod -R 775 /var/www
4. Next step would be to install PHP5 and enbale all necessary modules:
>sudo apt-get install php5-common php5-cgi php5
>sudo lighty-enable-mod fastcgi
>sudo lighty-enable-mod fastcgi-php
>sudo service lighttpd force-reload
5. To install the dashboard you should install git
>sudo apt-get install git
6. Now you can clone the dashboard into your home-directory (`/home/pi`) with
>git clone https://github.com/dg9vh/MMDVMHost-Dashboard.git
7. Now it's time to copy the files into the webroot:
If you are using Raspbian Jessie, you do it with
>cp -R /home/MMDVMHost-Dashboard /var/www/html/
If you are using Raspbian Wheezy, you do it with
>cp -R /home/MMDVMHost-Dashboard /var/www/
8. To make sure that the dashboard is delivered by the webserver, remove the default "index.html" within the webroot-directory /var/www/html respective /var/www with
>rm index.html
9. When this is done you should configure the dashboard by editing /var/www/html/config/config.php respective /var/www/config/config.php to your personal fits.
10. Last step is to put www-user into sudoers by editing `/etc/sudoers` with
>sudo nano /etc/sudoers
and adding the line:
>www-data ALL=(ALL) NOPASSWD: ALL
at the end of the file.
After all is done the dashboard should be reachable via http://IP-OF-YOUR-HOTSPOT/
##Configuration Of Dashboard
When configuring the dashboard take care of the directories containing the logs etc. If here you are doing something wrong, no last-heard or other info would be shown in the dashboard!