MMDVMHost-Dashboard/linux-step-by-step.md

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. Update your system:

   sudo apt-get update && sudo apt-get upgrade

2. Install a lightweight webserver:

   sudo apt-get install lighttpd

3. Create a group for the webserver and add yourself to it:

   sudo groupadd www-data

   sudo usermod -G www-data -a pi

4. Set permissions so you and the webserver have full access to the files:

   If you use a current Raspbian Jessie, Raspian Stretch & Raspbian Buster, 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

5. Install PHP and enable the required modules:

   If you use a Raspian Wheezy and Raspbian Jessie use:

   sudo apt-get install php5-common php5-cgi php5

   If you use a Raspian Stretch or Raspbian Buster use:

   sudo apt-get install php7.3-common php7.3-cgi php

if you want to use the sqlite3-database based resolving of the operator-names you need following, too Raspian Wheezy and Raspbian Jessie:

>sudo apt-get install sqlite3 php5-sqlite

Raspian Stretch:

>sudo apt-get install sqlite3 php7.0-sqlite

Raspian Buster:

>sudo apt-get install sqlite3 php7.3-sqlite3	

Now continue with:

>sudo lighty-enable-mod fastcgi

>sudo lighty-enable-mod fastcgi-php

>sudo service lighttpd force-reload

6. To install the dashboard you should use git for easy updates:

   sudo apt-get install git

7. Now you can clone the dashboard into your home directory:

   cd ~

   git clone https://github.com/dg9vh/MMDVMHost-Dashboard.git

8. Next, you need to copy the files into the webroot so they can be served by lighttpd:

   If you are using Raspbian Jessie, Raspian Stretch or Raspbian Buster, run:

   sudo cp -R /home/pi/MMDVMHost-Dashboard/* /var/www/html/

   If you are using Raspbian Wheezy, run:

   sudo cp -R /home/pi/MMDVMHost-Dashboard/* /var/www/

9. To make sure the dashboard is served instead of the default "index.html", cd into the webroot /var/www/html respectively /var/www and remove that file:

   sudo rm index.html

10. Finally, you need to configure the dashboard by pointing your browser to http://IP-OF-YOUR-HOTSPOT/setup.php . This will create /var/www/html/config/config.php respectively /var/www/config/config.php which contains your custom settings.

Now the dashboard should be reachable via http://IP-OF-YOUR-HOTSPOT/

##Configuration Of Dashboard When configuring the dashboard, make sure to set the correct paths for logs etc. If they are wrong, no last-heard or similar information will be shown on the dashboard!