Downloads & Setup

Everything you need to get started with Controll. Download the hub software, follow our setup guide, and have your first installation running in minutes.

Available Downloads

Select the right package for your hardware

Controll Hub Image

Coming Soon
v1.0.0 - Raspberry Pi 4/5

Complete SD card image with Home Assistant and Controll Hub Agent pre-installed. Just flash, boot, and connect.

Download Image
~2.4 GB - Raspberry Pi OS Lite + HA

Hub Agent Package

Coming Soon
v1.0.0 - Add-on for existing HA

Add Controll to your existing Home Assistant installation. Works with HAOS, Docker, and Supervised installs.

Download Package
~15 MB - Python package

Installation Guide

PDF - 12 pages

Complete installation and configuration guide. Includes hardware recommendations, network setup, and troubleshooting.

View Documentation
Also available in NL, DE, FR

System Requirements

What you need before you start

Raspberry Pi 4 or 5

Minimum 4GB RAM recommended. 8GB for larger installations.

32GB+ SD Card or SSD

SSD via USB strongly recommended for reliability.

Ethernet Connection

Wired connection required for initial setup. WiFi can be configured later.

Controll Account

Free installer account at portal.controll.it

Project Created

Create a project in the portal before pairing the hub.

Device ID or Pairing Code

Pre-assigned device ID or generated pairing code from portal.

Quick Setup Guide

Get up and running in 4 simple steps

1

Flash the Image

Download the Controll Hub image and flash it to your SD card or SSD using Raspberry Pi Imager or balenaEtcher.

balenaEtcher controll-hub-v1.0.0.img.gz /dev/sdX
2

Boot & Connect

Insert the SD card, connect ethernet, and power on. The hub will boot and show a setup screen on the connected display (optional).

3

Enter Device ID

Access the setup wizard at http://controll-hub.local:8080 or via the displayed QR code. Enter your Device ID or Pairing Code.

Device ID: CTL-2026-XXXXX
4

Start Configuring

Once paired, the hub appears in your portal dashboard. Configure Home Assistant, add integrations, and manage everything remotely.

Frequently Asked Questions

Can I use my existing Home Assistant installation?

Yes! The Hub Agent package can be installed on any existing Home Assistant installation running HAOS, Docker, or Supervised. You'll just need to install our add-on and enter your project credentials.

What happens if the internet goes down?

Home Assistant continues to run locally. All automations, scenes, and local control work without internet. You just won't be able to access the hub remotely until connectivity is restored.

How do I get a Device ID?

Device IDs are assigned to pre-provisioned Controll Hub hardware. If you're using your own hardware, use the Pairing Code method instead - generate a code in the portal and enter it during hub setup.

Is my data secure?

All communication between the hub and Controll is encrypted with TLS. Your Home Assistant data stays local - we only sync status information and relay commands. No cloud dependency for day-to-day operation.

What integrations are supported?

Controll works with all Home Assistant integrations. This includes KNX, Z-Wave, Zigbee, Matter, Hue, Sonos, and thousands more.

See our integrations page

Ready to Get Started?

Create your free installer account and set up your first project today.