Installation-guide.md

@@ -10,7 +10,7 @@ These are required before you try to proceed
 
 We recommend using Linux (we use Debian). 
 
-Our servers run file with  1 CPU and 1 Gb RAM. A virtual server is fine. 
+Our servers run fine with  1 CPU and 1 Gb RAM. A virtual server is fine. 
 
 ### Python3 and pip3
 
@@ -20,8 +20,75 @@ Freedmr uses Python3 so, first and foremost, please ensure that Python3 and pip3
 
 You should have a DMR radio and repeater or hotspot and know how to use and configure them.
 
+### A working MySQL or MariaDB database server 
+
+Installing this is out of scope for this guide. 
+
+Note, FreeDMR will run without the database, but one of the most useful features - being able to change the configuation of systems without restarting, will not work. 
+
 ### Join the community!
 
 Our group for system builders can be found here: https://t.me/joinchat/RFnEhSEpz1P4AJM1
 
+## Installation
+
+Now, let's install FreeDMR :-)
+
+### Download source
+
+[Version 1](https://github.com/hacknix/FreeDMR/archive/v1.0.tar.gz)
+
+### Prepare source
+
+`#tar zxvf v1.0.tar.gz`
+`#cd FreeDMR`
+
+### Install required Python modules 
+
+`#sh ./install.sh`
+
+### Create database (recommended)
+
+First you will need to create a database and a user. There are plenty of resources online to tell you how to do this.
+
+Once you are done:
+
+`#mysql -u <your user> -p <your password>`
+`> use <your db>;`
+
+Then, please paste the contents of the file repeaters.sql from the source directory into the console. This should create a new table called repeaters. 
+
+next paste in the following:
+
+`>insert into repeaters VALUES ('<your call>','MASTER',1,1,1,0,'',54001,'passw0rd',5,1,'DENY:1','DENY:1','PERMIT:ALL','PERMIT:ALL',10,1,1,'','',0);`
+
+`>quit`
+
+### Edit configuration 
+
+`#mkdir config`
+`#cp FreeDMR-SAMPLE.cfg config/FreeDMR.cfg`
+`#cp rules_SAMPLE.py config/rules.py
+
+Using your favourite editor, edit the file config/FreeDMR.cfg
+
+If you are using a database (recommended), remember to configure and enable the MySQL section and leave the MASTER system example set to ENABLED=False
+
+If you are not using a database, make sure MySQL is set to ENABLED=False and the MASTER section is appropriately configured and set to ENABLED=True
+
+_Please leave the OpenBridge configuration disabled until you are familiar with how FreeDMR works_
+
+### Start FreeDMR
+
+`#python3 ./bridge_master.py -c ./config/FreeDMR.cfg -r ./config/rules.py`
+
+### Connect a system 
+
+If all goes well, you should now be able to connect a system to your server on port 54001
+
+### User's guides
+
+You can find more details on how to use FreeDMR from the user perspective at [http://www.freedmr.uk](http://www.freedmr.uk)
+
+