Run OctoBot, the free and open-source cryptocurrency trading bot, directly inside Home Assistant — no separate server, no Docker commands, no terminal. Install it like any other add-on and manage your strategies from a web interface right next to your smart home.
- Automated trading, 24/7 — OctoBot runs your strategies around the clock on your own hardware. Your keys and your data never leave your machine.
- One-click install — add the repository, pick a channel, hit install. The Supervisor handles the rest.
- Runs where your home runs — on the same Raspberry Pi, NUC, or server as
Home Assistant. Supports
aarch64andamd64. - Modern Node web interface — configure exchanges, strategies, and monitoring from a clean UI, reachable straight from the add-on's Open Web UI button.
- Survives updates and reboots — your configuration, logs, and backtesting
data are persisted under Home Assistant's
/data, so add-on rebuilds and updates keep your setup intact.
- 📈 Automated crypto trading on many major exchanges
- 🧩 Extensible via OctoBot's tentacles (strategies, evaluators, trading modes)
- 🔒 Self-hosted — API keys stay on your device
- 🖥️ Built-in Node web interface (port
8000, path/app) - 💾 Persistent user config, logs, and backtesting data
- 🏗️ Multi-architecture images (
aarch64,amd64)
OctoBot — stable
Tracks the stable OctoBot Docker image channel. Recommended for everyday use —
tested releases, fewer surprises.
OctoBot DEV — bleeding edge
Tracks the latest OctoBot Docker image channel. Newest features and fixes,
straight from active development. Expect rougher edges — best for testing and
early adopters.
- Add this repository to Home Assistant — click the button above, or go to
Settings → Add-ons → Add-on Store → ⋮ → Repositories and paste:
https://github.com/drakkar-software/octobot-home-assistant - Install the OctoBot (stable) or OctoBot DEV add-on from the store.
- Start the add-on.
- Click Open Web UI (or browse to
http://<your-ha-host>:8000/app) to reach the OctoBot Node interface and finish setup.
| Option | Default | Description |
|---|---|---|
enable_node_api |
true |
Enable the Node web interface / API served on port 8000 |
The web interface is exposed on port 8000 at path /app.
The add-on runs OctoBot with its working directory on Home Assistant's
persistent /data, so your user configuration, logs, and backtesting data
survive rebuilds and updates.
Tentacles are intentionally not persisted — they are wiped and reinstalled fresh on every start, so each boot pulls a clean default tentacles set matching the running OctoBot version.