dathbe edited this page May 24, 2016 · 11 revisions

openHAB iOS is an open-source application providing openHAB user interface on iOS platform. It is an integral part of openHAB project.

Basic information on iOS app

Please use openHAB iOS issues to submit bugs, feature requests and ideas on how to improve the iOS native app.

Connecting to openHAB

iOS app uses Bonjour/mDNS service discovery to find openHAB in local network. During startup iOS app detects the type of active network connection. If WiFi is used for network connection iOS app tries to discover openHAB. If iOS app is unable to discover openHAB on local network, it assumes this is not a home network and uses Remote URL from application settings to connect to openHAB. It goes the same way if mobile network connection is detected. All settings, including username, password and remote URL can be configured through 'Settings' menu which is available at any point by clicking 'Settings' on the top right corner of the screen. You can also configure a static URL (openHAB URL) in Settings and openHAB will never try to discover and will connect to this URL during startup. If local URL is not reachable app will failover to remote URL. When you connect to openHAB for the first time iOS app will ask you to select sitemap from the list of available sitemaps. It will remember your decision and open this sitemap automatically next time you launch the app. You can switch sitemap anytime using 'Select sitemap' from settings menu.

The Local URL should be entered like this:


The Remote URL should be entered like this:


Adding /openhab.app or more is not necessary and will cause a failed connection.


We strongly recommend to use HTTPS, though HTTP is also available.

If username and password are configured iOS app will automatically use them for authenticating http requests to openHAB. If openHAB doesn't have any security configured iOS app will connect to openHAB anyway.

We strongly recommend to switch on user authentication in openHAB when enabling remote connection over the Internet!

User experience

iOS app is currently designed for mobile phones and tablets running iOS 7.

iOS app supports all openHAB sitemap widgets.

iOS app supports disabling screen timeout timer while iOS app is running. This is useful for those who use iOS device as a wall control panel. This can be set through Settings menu.

openHAB version support

iOS app is compatible with openHAB version starting from 1.0.0.

Using application

Please install release version of iOS app from the App Store:


feature overview


Setup intro

Linux and OS X





User Interfaces



(link to openHAB forum)



Application Integration



A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules


Syntax highlighting for external editors

Release Notes

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.