Home Automation Raspberry Pi setup

Raspberry Pi install

Setup locale

• sudo raspi-config
• Localizations options > Locale
• Disable en_GB
• Enable en_US.UTF-8
• sudo nano /etc/default/locale
  • and add this:

    LC_CTYPE=en_US.UTF-8
    LC_ALL=en_US.UTF-8
    

Update system

• sudo apt update && sudo apt full-upgrade && sudo apt -y dist-upgrade
• sudo apt autoremove

Install python3

• sudo apt-get install libffi-dev libssl-dev -y
• sudo apt install python3-dev -y
• sudo apt-get install python3 python3-pip -y

Install Docker + Docker compose

https://docs.docker.com/engine/install/debian/

• curl -fsSL https://get.docker.com -o get-docker.sh
• sudo sh get-docker.sh
• sudo usermod -aG docker pi
• groups pi
• sudo pip3 install docker-compose
• sudo systemctl enable docker

Upgrade Docker

• sudo apt-get upgrade

Docker useful commands

• docker ps to list current containers
• docker restart [container name]

Uninstall Docker

• sudo apt-get purge docker-ce
• sudo apt-get purge docker-ce-cli
• sudo rm -rf /var/lib/docker

Install Home Assistant (discontinued)

• mkdir /home/pi/homeassistant && cd /home/pi/homeassistant
• nano docker-compose.yml

Add this to the docker-compose.yml file:

---
version: "2.1"
services:
  homeassistant:
    image: lscr.io/linuxserver/homeassistant
    container_name: homeassistant
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Prague
    volumes:
      - /home/pi/homeassistant/data:/config
    devices:
      - /dev/ttyACM0:/dev/ttyACM0
    privileged: true
    restart: unless-stopped

• sudo docker-compose up -d

Using custom ZHA quirks in Docker installed Home Assistant

• mkdir /home/pi/homeassistant/data/custom_zha_quirks
• nano /home/pi/homeassistant/data/configuration.yml

Add this to the end of the config:

zha:
  custom_quirks_path: /config/custom_zha_quirks/

Download and unpack quirks from downloaded zip. Move desired custom quirk .py files to the custom_zha_quirks folder

• cd /home/pi/homeassistant/data/custom_zha_quirks
• curl -fsSL https://github.com/zigpy/zha-device-handlers/archive/refs/tags/0.0.63.zip -o 63.zip && unzip 63.zip

Martin Púčik

Swift Developer