This repository is an artifact of my frustration with trying to keep my home automation stack current. It's a simple Docker Compose stack with Home Assistant, Node-RED, and MariaDB, but with some automation workflows around config management and keeping everything updated. This is more a personal convenience, but perhaps you might find it helpful.
This script assumes you're installing on Ubuntu Server 20.04.
curl -sSL https://raw.githubusercontent.com/lukiffer/ha/main/scripts/bootstrap.sh | bashThis script will install all the necessary prerequisites and clone this repository to /opt/ha/. Before starting the
service you must configure the submodule that contains your config and import the GPG used to encrypt your secrets.
The included submodule layout assumes a repository with the following file structure:
(root)
├─ homeassistant/
├─ nginx/
╰─ nodered/
Where each directory is the configuration root of the respective application.
- You can update
.gitmodulesto point at your copy of such a repository and then run:git submodule sync --recursive
- If you've already done this in your fork of this repository, you can simply run:
git submodule update --init --recursive
Note that you may be required to logout and back in if you're running in the same shell session that was use to run the bootstrap script – your group membership will not be current in that session.
Once you've configured the config submodule, you can start the Compose stack by running:
sudo systemctl start home-automation.serviceYou can update to the latest version of each component's published containers by running:
sudo /opt/ha/scripts/update.shNote that the stack will be temporarily offline during the update.
All declarative configuration files are assumed to be stored in source control (in the config submodule). You can use
the backup.sh script to capture a signed, encrypted backup of all configuration paths.
/opt/ha/scripts/backup.sh --gpg-key <GPG_KEY_ID>