Comprehensive Guide to Installing HomeAssistant, Docker, and Additional Services on ARMbian Systems

System Preparation and Repository Configuration

# Backup current repository configuration
sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup

# Update to mirror repository
sudo bash -c 'cat > /etc/apt/sources.list' << EOF
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-security main restricted universe multiverse
EOF

# Update package lists
sudo apt-get update

# Remove obsolete packages
sudo apt-get autoremove

# Clean package cache
sudo apt-get clean

If you encounter GPG key verification errors during update, manual import the missing key:

gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 871920D1991BC93C
gpg --export --armor 871920D1991BC93C | sudo apt-key add -

HomeAssistant Installation and Configuration

# Pull the latest HomeAssistant image
docker pull homeassistant/home-assistant:stable

# Create and run the container
docker run -d --restart=always --name="homeassistant" \
  -v /homeassistant_data/config:/config \
  -p 8123:8123 \
  homeassistant/home-assistant:stable

# Access container and install HACS
docker exec -it homeassistant bash
mkdir -p /config/custom_components/hacs
cd /config/custom_components/hacs

# Download HACS (requires internet access)
wget -O - https://get.hacs.xyz | bash

# Extract and restart
unzip hacs.zip
exit
docker restart homeassistant

Docker and CasaOS Installation

# Docker installation (skipped if installing CasaOS)
sudo apt-get install docker.io -y

# CasaOS installation
wget -qO- https://get.casaos.io | bash

# Install text editor
sudo apt-get install nano -y

Alist File Manager Setup

# Manual Alist installation with media mounting
docker run -d --restart=always \
  -v /etc/alist:/opt/alist/data \
  -v /media:/media \
  -p 5244:5244 \
  -e PUID=0 -e PGID=0 -e UMASK=022 \
  --name="alist" \
  xhofe/alist:latest

# Set admin password
docker exec -it alist ./alist admin set YourSecurePassword123

Qinglong Panel Installation

# Pull and run Qinglong container
docker pull whyour/qinglong:latest
docker run -tid \
  --name qinglong \
  -p 5700:5700 \
  --restart always \
  whyour/qinglong:latest

ZeroTier Network Configuration

First, create an account and network on the ZeroTier website.

# Deploy ZeroTier container
docker pull bltavares/zerotier:latest-arm32v7
docker run --device=/dev/net/tun \
  --name zerotier \
  --net=host \
  --restart=always \
  --cap-add=NET_ADMIN \
  --cap-add=SYS_ADMIN \
  -v /var/lib/zerotier-one:/var/lib/zerotier-one \
  -d bltavares/zerotier:latest-arm32v7

# Join your network (replace with your Network ID)
docker exec zerotier zerotier-cli join your_network_id_here

BitTorrent Client Installation

Transmissoin Setup

# Install Transmission daemon
sudo apt-get install transmission-daemon -y

# Stop service for configuration
sudo systemctl stop transmission-daemon

# Configure access settings
sudo nano /etc/transmission-daemon/settings.json

Modify these settings in the configuration file:

"rpc-whitelist": "*",
"rpc-whitelist-enabled": false,
"rpc-username": "your_username",
"rpc-password": "your_encrypted_password"

# Apply Chinese language pack
wget https://github.com/ronggang/transmission-web-control/raw/master/release/install-tr-control-cn.sh
bash install-tr-control-cn.sh

# Restart service
sudo systemctl restart transmission-daemon

qBittorrent Installation (Recommended)

# Install qBittorrent-nox
sudo apt-get install qbittorrent-nox -y

# Create systemd service
sudo nano /etc/systemd/system/qbittorrent.service

Service configuration:

[Unit]
Description=qBittorrent Daemon
After=network.target

[Service]
User=root
ExecStart=/usr/bin/qbittorrent-nox
ExecStop=/usr/bin/killall -w qbittorrent-nox

[Install]
WantedBy=multi-user.target

# Enable and start service
sudo systemctl daemon-reload
sudo systemctl enable qbittorrent
sudo systemctl start qbittorrent

# Set media permissions
sudo chmod -R 755 /media

Docker qBittorrent Installation

# Deploy qBittorrent via Docker
docker run -d \
  --restart=always \
  --name qbittorrent-nox \
  --privileged=true \
  --stop-timeout 1800 \
  --tmpfs /tmp \
  -e QBT_EULA=accept \
  -e QBT_WEBUI_PORT=8080 \
  -e PGID=0 -e PUID=0 \
  -p 8080:8080/tcp \
  -p 6881:6881/tcp \
  -p 6881:6881/udp \
  -v /qbittorrent_data:/config \
  -v /media:/downloads \
  qbittorrentofficial/qbittorrent-nox

Klipper 3D Printer Setup

# System update
sudo apt update && sudo apt upgrade -y

# Create Klipper user
sudo useradd -m -s /bin/bash klipper
sudo passwd klipper
sudo usermod klipper -a -G sudo

# Switch to klipper user
su klipper
sudo apt install git -y

# Clone and run KIAUH installer
cd ~
git clone https://github.com/th33xitus/kiauh.git
./kiauh/kiauh.sh

Tags: ARMbian HomeAssistant docker CasaOS alist

Posted on Thu, 01 Oct 2026 16:32:14 +0000 by dmrn