This is the home of the official webapp for the AlarmDecoder family of home security devices.

• Supports all of the AlarmDecoder devices: AD2USB, AD2SERIAL and AD2PI.
• Web-based keypad for your alarm system
• Notifications on alarm events
• Multiple user accounts and per-user notifications and certificates (if configured)

• nginx >= 1.6
• gunicorn

NOTE: Other web and WSGI servers will likely work but will require configuration.

If you're running on a Raspberry Pi the easiest way to get started is to download our pre-configured Raspbian image. The image can be found at here.

If you'd rather do it by hand you can follow these steps:

1. sudo apt-get install gunicorn sendmail libffi-dev python-dev build-essential libssl-dev curl libpcre3-dev libpcre++-dev zlib1g-dev libcurl4-openssl-dev minicom telnet python2.7 autoconf automake avahi-daemon screen locales dosfstools vim python2.7-dev sendmail sqlite3
2. wget https://bootstrap.pypa.io/get-pip.py
3. sudo python get-pip.py
4. VERSION=1.7.4
5. curl http://nginx.org/download/nginx-$VERSION.tar.gz | tar zxvf -
6. cd nginx-$VERSION
7. ./configure --sbin-path=/usr/sbin/nginx --conf-path=/etc/nginx/nginx.conf --pid-path=/var/run/nginx.pid --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --with-http_ssl_module --with-ipv6
8. make
9. sudo make install
10. sudo mkdir -p /var/www
11. sudo mkdir -p /etc/nginx/ssl
12. sudo cp html/* /var/www
13. sudo cp /opt/alarmdecoder-webapp/contrib/nginx/nginx.service /lib/systemd/system/nginx.service
14. sudo systemctl daemon-reload
15. sudo service nginx start
16. sudo pip install gunicorn --upgrade
17. sudo ln -s /usr/local/bin/gunicorn /usr/bin/gunicorn
18. cd /opt/
19. sudo git clone http://github.com/nutechsoftware/alarmdecoder-webapp.git
20. cd alarmdecoder-webapp
21. sudo pip install -r requirements.txt
22. sudo python manage.py initdb
23. sudo cp contrib/nginx/alarmdecoder /etc/nginx/sites-available/
24. sudo ln -s /etc/nginx/sites-available/alarmdecoder /etc/nginx/sites-enabled/
25. sudo rm /etc/nginx/sites-enabled/default
26. sudo cp contrib/gunicorn.d/alarmdecoder /etc/gunicorn.d/
27. cd contrib/opencv/
28. ./opencv.sh
29. Edit /etc/gunicorn.d/alarmdecoder and change the user/group you'd like it to run as.
30. Change permissions on /opt/alarmdecoder-webapp to grant permissions for your chosen user.
31. Optionally install and set permissions for ser2sock
32. Create self-signed SSL certificate for HTTPS - sudo openssl req -x509 -nodes -sha256 -days 365 -newkey rsa:4096 -keyout /etc/nginx/ssl/alarmdecoder.key -out /etc/nginx/ssl/alarmdecoder.crt
33. Set your device locale: sudo dpkg-reconfigure locales
34. Set your keyboard mapping: sudo dpkg-reconfigure keyboard-configuration
35. Set your timezone: sudo dpkg-reconfigure tzdata
36. sudo service nginx restart
37. sudo service gunicorn restart

1. Copy the pi3-miniuart-bt-overlay.dtb from contrib/pi3_overlay to your root directory (/)
2. sudo vi /boot/config.txt
3. add the following to the end of the file: 2. dtoverlay=pi3-miniuart-bt-overlay
   1. force_turbo=1
4. sudo vi /lib/systemd/system/hciuart.service
   1. Replace ttyAMA0 with ttyS0

Please visit our forums.

We love the open-source community and welcome any contributions! Just submit a pull request through Github.