1.2 Installing the Alarm System

Install on a Raspberry Pi

The alarm system is intended for use on a Raspberry Pi 2 model B or a Raspberry Pi 3 model B running Raspberry Pi OS Lite. The Raspbian image (dated December 2nd 2020) can be downloaded from the [Raspberry Pi Downloads] (https://www.raspberrypi.org/downloads/raspbian/) web site.

At first boot, the Raspbian image has SSH disabled, so you will need to attach a keyboard and monitor to run stage 1 of the install in the table below. After that, you can continue the install either through the console, or through an SSH (terminal) session.

Logon using the pi account – you should be in the /home/pi directory by default

Stage	Linux command	Notes
1	sudo raspi-config	This starts the Raspberry Pi configuration utility. Select the following... Localisation Options | Change Timezone Localisation Options | Change Locale ( default is en_GB, you may need to change it ) Intefacing options | SSH enable System options | Hostname Finish and Reboot
2	sudo apt-get update	Download package lists for software repositories and update them with the newest versions of packages and dependencies.
3	sudo apt-get -y install git	Install the Git agent to allow downloads from the Git Hub.
4	mkdir Downloads	Downloads from the GitHub will be stored in this directory.
5	cd Downloads	Change into the Downloads directroy.
6	git clone git://github.com/oddwires/alarm-system.git	Download the alarm web app (copies all files from the Git Hub to the Download directory).
7	cd alarm-system	Move into the install directory.
8	chmod +x install.sh	Make install script executable.
9	sudo ./install.sh	Run the install script.
or if you are feeling lazy and want to copy/paste all of the above in one go, here it is all in one line... sudo raspi-config && sudo apt-get update && sudo apt-get -y install git && mkdir Downloads && cd Downloads && git clone git://github.com/oddwires/alarm-system.git && cd alarm-system && chmod +x install.sh && sudo ./install.sh

Stage 9 starts the installer which will...

• Install Operating System upgrades
• Install PostFix Mail Transfer Agent
• Install I2C utilities
• Install Apache and PHP
• Install Samba (Optional)
• Install Oddwires web application
• Install Oddwires Alarm daemon
• Install a Certificate Authority server and create self signed certificate chain.
• Install and configure Fail2Ban.
• Install and configure HomeKit Bridge (HAP-nodeJS).

Each stage gives you the options 'I' to install, 'S' to skip or 'Ctrl-C' to quit. The final stage of the installer reboots the Raspberry Pi to ensure the I2C bus initialises at the correct speed.

And thats the build finished.

Following the reboot, the alarm daemon (BASH script) will be running on the Raspberry Pi in the background, so there is no need to log on to the RasPi console. However, there is an option to control the script manually from the Linux command line:

• sudo service alarm stop - stops the alarm service.
• sudo service alarm start - starts the alarm service and grabs the screen output allowing commands being passed from the web pages to be viewed on the console.
• sudo service alarm restart - restarts the alarm service.

From your iPhone you should be able to browse to the system. The default user account is...

• Logon = admin
• Password = qwerty

If no hardware is connected, all alarm zones will show as 'open'.

By loging in to the system, you can use your iPhone to...

• Adminster user accounts - create, delete, change.
• Configure Alarm Zones - create, delete, change.
• Configure Radio Control circuits - create, delete, change.
• Configure Schedule tasks - switch remote devices on/off, check router for IP changes, enable/disable the alarm.
• Configure email credentials - allowing the system to send email alerts.
• Set names and configuration details for alarm zones and radio control channels.
• Store and load user defaults.
• Restore factory defaults
• View log files.