Fast Deploy

Setup and deploy projects through docker in the Raspberry Pi.

Specifically this guide sets up a Duck DNS domain over HTTPS running Home Assistant secured with Fail2ban.

This setup has been develop against the raspberry pi 2 / 3 (ARM version 7 / 8). Check the architecture of your system and tweak the docker images accordingly.

Content

This setup includes:

• Traefik - The Cloud Native Edge Router.
• Let’s Encrypt - Let’s Encrypt is a free, automated, and open Certificate Authority.
• Duck DNS - Duck DNS free dynamic DNS hosted on Amazon VPC.
• Fail2ban - Fail2ban scans log files and bans IPs that show the malicious signs.
• Eclipse Mosquitto - Eclipse Mosquitto is an open source message broker that implements the MQTT protocol.
• Home Assistant - Open source home automation that puts local control and privacy first.
• AppDaemon - AppDaemon is a loosely coupled, multithreaded, sandboxed, pluggable python execution environment for writing automation apps for Home Assistant home automation software.
• deCONZ - deCONZ is a software that communicates with Conbee/Raspbee Zigbee gateways and exposes Zigbee devices that are connected to the gateway.

To add or remove components just tweak the docker-compose file.

Requirements

Linux / Mac OS

• wget
• unzip
• rsync
• docker

Installation Guide

1 Lets start creating a environment variables file

cp .sample.env .env

2 Open .env and fill REPLACE_ME with your data and save the file.

3 Evaluate the environment variables file:

source .env

4 Give execution permissions to the setup script:

chmod +x setup

5 Download additional resources

./setup init

6 After running a new folder called config should have been created.

7 Insert a micro sd

8 Flash the sd card choosing one of the following commands

./setup flash_sd

./setup flash_sd_wifi

9 Put the micro sd in and boot the system.

Last steps

Once the system is up, send the config through ssh:

./setup export_config

Let's connect to the pi and run the system:

ssh ${USERNAME}@${HOSTNAME}.local

docker-compose up -d

Once all works, import the data from rpi and store it in a safe place

./setup backup

Disclaimer

This repository is heavily based on the following work:

• HypriotOS - HypriotOS is the fastest way to get Docker up and running on the Raspberry Pi.
• flash - Command line script to flash SD card images of any kind.
• Configurer - A config render tool based on Jinja template variables.