Get Aloha

Two ways to run it. On a VM or a Raspberry Pi, use Home Assistant OS and add the Aloha add-on — that gives Aloha full run of the box (updates, add-ons, backups). Already have your own host? Use the Docker image.

🏠 Appliance recommended

Home Assistant OS + the Aloha add-on — for a VM (Proxmox / VirtualBox / VMware) or a Raspberry Pi / arm64 SBC.

  1. Install Home Assistant OS. Grab the official image for your platform from home-assistant.io/installation (OVA/qcow2/VHDX for VMs; use Raspberry Pi Imager → Home Assistant OS for a Pi). Boot it and finish onboarding.
  2. Add the Aloha add-on repository. Settings → Add-ons → Add-on store → ⋮ → Repositories, and add:
    https://github.com/sackio/aloha
  3. Install “Aloha” from the store, then Start. Open it from the sidebar.
HA install images ↗

🐳 Docker bring your own host

Bundles Home Assistant + the agent in one container. Runs anywhere Docker does (amd64 / arm64).

docker run -d --name aloha \ -p 8123:8123 -p 7123:7123 \ -v aloha-data:/data \ ghcr.io/sackio/aloha:latest

Home Assistant → :8123 · Aloha → :7123. Already run Home Assistant? Start with -e ALOHA_MODE=standalone -e ALOHA_HA_URL=http://your-ha:8123 and drop the 8123 mapping.

Image on GHCR ↗