[wiki] Getting Started with OH3: rewriting the tutorial - 3. Adding a Thing (simple)

Tags: #<Tag:0x00007f616cf99690> #<Tag:0x00007f616cf995c8>

This Wiki topic’s goal is to serve as a working document, in order to provide an up-to-date tutorial for OH3 aimed at new users and novices. Everyone is welcome and encouraged to edit it, when we’re satisfied it will make its way to the official docs. You may reply for the specific purpose of improving the article are allowed, but please, this is NOT a support thread: if you’re stuck while reading this and are simply seeking support please open another thread. Thanks!

Scenario: you have Philips Hue lightbulbs connected to an official Hue bridge. In this case, the Hue binding supports autodiscovery of both the bridge and the bulbs and other devices.

From the Settings screen, or on the sidebar while you’re in Settings, click on Things.

Click on the blue “+” button in the bottom-right corner.

Since you have no bindings, this screen will appear:

Click on Install Bindings.

Look for the Hue binding (or search for it with the search bar at the top), click on it then Install:

It might take from a few seconds to a minute for the binding to install…

Wait for it to disappear from the list, then click < Back (or use the browser controls).
The Hue binding will now appear on the previous screen. You can also notice that it has already detected something (the red “1” badge).

Click on the binding.

The bridge has indeed been detected and appears under Discovered Things. If not you can try again by clicking on the Scan Again button.

Click on the discovered bridge.

openHAB will ask you to confirm or change the label. Click OK.

You will be taken back to the Things page, where the Hue bridge should now appear:

However, we can see that it’s marked offline. Let’s see why - click on the bridge.

The error description below the status gives some more information: you have to press the physical button on the device to let openHAB authenticate to it. Once you’ve done this, the Thing will become online:

Go back to Things.
You will notice a new red button on that screen:


It means that there are new discovered devices that you can add; since the Hue bridge is now working, the binding has detected all the Hue devices (bulbs, switches and so on) attached to it.

The Inbox is a consolidated view of all the discovery results, alternatively you can also click on the “+” button to get a per-binding view, and the ability to perform a new scan.

Click Inbox.

You can either click on an individual thing to see actions related to it, or you can click on Select in the top-right corner to add checkboxes beside items, which will allow you to perform actions on several inbox entries at once.


These actions are:

  • Approve: promote the candidate from the Inbox to a Thing
  • Ignore: hide the candidate from the list (you will be able to see it again and un-ignore it by clicking on “Show ignored” above the list
  • Remove: remove the candidate from the Inbox (it might be detected again later).

Go back to Things: the newly approved Hue Things should appear on the list.

1 Like

As I mentioned I wonder if the Network binding or Astro binding would make a better example here as it will allow the user to follow along in their own system without possessing Hue devices. But that binding won’t show everything demonstrated here (the offline until clicking the button for example). Maybe we keep this one and add Network?

I do think it’s important to present the users at least in part with something they can do themselves regardless of what hardware they have.


3 posts were split to a new topic: Prominence of add & save button on OH3’s UI

This topic was automatically closed 41 days after the last reply. New replies are no longer allowed.