Installation

Docker

If you have docker running, this will be the easiest way:

mkdir pai/etc pai/log

wget https://raw.githubusercontent.com/ParadoxAlarmInterface/pai/master/config/pai.conf.example -O pai/etc/pai.conf

edit pai/etc/pai.conf as needed, see [Configuration](./Configuration).

docker run -it \
-v /etc/timezone:/etc/timezone:ro
-v /etc/localtime:/etc/localtime:ro
-v pai/etc:/etc/pai:ro \
-v pai/log:/var/log/pai \
--user $(id -u):$(id -g) \
--device=/dev/tty.YOUR_SERIAL_PORT \
paradoxalarminterface/pai:latest

You can also try dev(less stable) branch with new features paradoxalarminterface/pai:dev-latest

The docker images do not have support for Signal.

Manually

1. Download the files in this repository and place it in some directory

git clone https://github.com/ParadoxAlarmInterface/pai.git

2. Copy config/pai.conf.example to /etc/pai/pai.conf and edit it to match your setup. The file uses Python syntax.

mkdir -p /etc/pai
cp config/pai.conf.example /etc/pai/pai.conf
edit /etc/pai/pai.conf as needed
python3 run.py

Alternatively see Configuration section for supported file locations.

3. Install the python 3.6 and its requirements.

pip3 install -r requirements.txt

If some requirement fail to install, this may not be critical.

• gi, pygobject and pydbus are only required when using Signal
• Pushbullet.py and ws4py are only required when using Pushbullet
• chump is only required when using Pushover
• paho_mqtt is only required for MQTT support
• pyserial is only required when connecting to the panel directly through the serial port or using a GSM modem.

4. Run

python3 run.py

If something goes wrong, you can edit the configuration file to increase the debug level.