Setup OpenHome OS on Your Own Raspberry Pi

Documentation Index

Fetch the complete documentation index at: https://docs.openhome.com/llms.txt

Use this file to discover all available pages before exploring further.

​

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

​

Step 1: Download Required Software

• Download Raspberry Pi Imager from the official Raspberry Pi website for your operating system and install it.

• 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 System → Use custom → select the downloaded OpenHome image file.
• Click Choose Storage and select your SD card.

• Click Next. When prompted, click No and continue.

• 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.

• Once complete, you will see a success status.

​

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.

• The call should start automatically. If it doesn’t, click Restart Agent.

​

Setup Complete