Skip to main content
This guide is for developers setting up OpenHome on their own Raspberry Pi who do not have an official OpenHome DevKit.

Prerequisites

  • Raspberry Pi (Zero 2 W, Pi 4, or Pi 5)
  • SD card (8GB minimum)
  • USB card reader or adapter
  • Your Pi’s recommended charger
  • Bluetooth speaker
  • USB microphone
  • Computer with internet access
Interruption is not supported on custom Raspberry Pi hardware. The Agent cannot be interrupted while speaking (TTS) or during music mode. Plan your Ability flows accordingly and handle these states gracefully when building.

Step 1: Download Required Software

  • Download Raspberry Pi Imager from the official Raspberry Pi website for your operating system and install it.
Raspberry Pi Imager
  • Download the OpenHome DevKit OS image from here.

Step 2: Burn the OpenHome Image to the SD Card

  • Insert your SD card into the USB card reader and connect it to your computer.
  • Open Raspberry Pi Imager, click Choose Device and select your Raspberry Pi model.
  • Click Choose Operating SystemUse custom → select the downloaded OpenHome image file.
  • Click Choose Storage and select your SD card.
Raspberry Pi Imager Setup
  • Click Next. When prompted, click No and continue.
Raspberry Pi Imager Prompt
  • Click Write to burn the image. This may take a few minutes.

Step 3: Set Up the Raspberry Pi

  • Insert the SD card into your Raspberry Pi.
  • Connect your Raspberry Pi to power and turn it on.

Step 4: Create a New User on OpenHome

  • If you don’t have an account, create one at app.openhome.com.
  • If you already have an account but no password set, use Forgot Password or set one from Profile → Settings.

Step 5: Connect to OpenHome Wi-Fi

  • Connect your device to the Wi-Fi network named OpenHome_MACADDRESS.
  • The setup page should open automatically. If it doesn’t, open a browser and go to http://192.168.50.1.
  • Follow the on-screen instructions to configure your Wi-Fi and log in with your OpenHome credentials.
Device Setup OpenHome Login
  • Once complete, you will see a success status.
Setup Success

Step 6: Connect to Your Internet Wi-Fi

  • Disconnect from OpenHome_MACADDRESS and reconnect to your regular home Wi-Fi.
  • Go to app.openhome.com and log in with the same account.

Step 7: Configure Bluetooth Speaker

  • Navigate to Profile → Settings → DevKit. Your device should be listed as connected.
  • Turn on Bluetooth on your speaker.
  • Click Scan Bluetooth Devices in the OpenHome app and select your speaker from the list.
  • Ensure the profile is set to a2dp-sink. If it doesn’t appear, try reconnecting.
  • Connect your USB microphone to the Raspberry Pi and set the default input to analog-mono.
Mic and Speaker Setup
You should see two connected devices: a mic and a speaker. Known limitation (current OpenHome Pi Zero image): interruption is not supported yet.
  • The call should start automatically. If it doesn’t, click Restart Agent.

Setup Complete

Your OpenHome OS is now set up on your Raspberry Pi. You can now enjoy OpenHome on your Raspberry Pi.