Articles in this section

See more

Set up your Homey Bridge

  • Updated

Set up Homey Bridge to add your devices to Homey and control them from the Homey app. The steps depend on whether you already have a Homey account.

Before you start
Turn on Bluetooth on your phone or tablet and allow the Homey app to access your location. The Homey app needs both to find Homey Bridge.

In the box

  • Homey Bridge
  • Power adapter
  • Power cable

If you’re new to Homey

  1. Plug in Homey Bridge with the supplied power adapter and cable. The LED ring rotates white. When it breathes blue, Homey Bridge is ready for setup.
  2. On your phone or tablet, download the Homey app from get.homey.app.

  3. Open the Homey app and tap Create Account.

    The Welcome Home screen in the Homey app with the Create Account and Sign In buttons

  4. Follow the steps in the app to create your account.

  5. Tap Set Up Homey → Homey Bridge.

    An illustration of a mobile device showcasing the option to set up a new Homey

  6. If you have a Homey Pro or Homey Pro mini, tap it to set it up first. Otherwise, tap Homey Cloud.

    A phone screen asking whether you have a Homey Pro, with options for Homey Pro, Homey Pro mini and Homey Cloud

  7. Follow the steps in the app to finish setup.

If you already have a Homey account

  1. Plug in Homey Bridge with the supplied power adapter and cable. The LED ring rotates white. When it breathes blue, Homey Bridge is ready for setup.
  2. In the Homey app, go to Devices.

  3. Tap Circled plus icon in the upper-right corner, then tap New Device.

    A phone screen showing the New Device option in the Homey app

  4. When the Homey app finds Homey Bridge, tap Connect Homey Bridge.

    A phone screen showing a Homey Bridge and a Connect button in the Homey app

  5. Follow the steps in the app to finish setup.

Troubleshooting

The Homey app doesn’t find Homey Bridge
  • Check that the LED ring breathes blue. This means Homey Bridge is ready for setup. If it still rotates white, wait until it changes.
  • Check that the Homey app is up to date.
  • Check that Bluetooth is on and that the Homey app has permission to use Bluetooth and access your location.
Homey Bridge doesn’t connect to Wi-Fi

Homey Bridge uses Wi-Fi 802.11b/g/n and Bluetooth Low Energy 4.2, both on the 2.4 GHz band. Connect Homey Bridge to a 2.4 GHz Wi-Fi network.

Homey Bridge doesn’t connect to Homey

If you use Homey Pro, Homey Pro mini or Homey Self-Hosted Server

Homey Bridge connects directly to your Homey over your local network. During setup, it needs internet access once to find out which Homey to connect to.

Check that your network allows a direct connection between Homey Bridge and your Homey. In most networks, this means:

  • Both are on the same VLAN and subnet.
  • Client isolation and access point isolation are turned off.
  • Neither is connected to a guest network.

If you use Homey Cloud

Homey Bridge needs a permanent internet connection to reach the Homey Cloud servers. Check that your network settings, such as your firewall, allow this.

Error: “Your Homey Bridge couldn’t be verified”

Contact our support team and mention this error. They can help you with the next steps.

Related articles