Skip to main content
Version: Next

On mobile

The OpenRemote Manager including the Insights dashboards, are responsive and can be used on mobile devices. We have an OpenRemote app in the Apple and Google stores which can be used as well. To make use of the services of mobile devices (e.g. location service and push notifications) you have to build your own app, using the project source code.

Creating dashboard apps OpenRemote

OpenRemote iOS and Android App​

OpenRemote includes consoles for iOS and Android. The current apps we are hosting on the App Store and on Google Play, can connect to your OpenRemote Manager instance. To use these apps for your own OpenRemote installation follow these three steps:

  1. By default you can view two types of apps for your OpenRemote instance, the 'manager' app and the 'insights' app. The 'manager' app will display all Manager pages, except the 'rules'. The 'insights' page will only show the dashboards created on the Insights page. Basically it allows you to create a simple standalone dashboard app for your users.

  2. Before deploying OpenRemote, you have the possibility to define which apps are ignored for the consoles. Apps reside in the ui/app folder. By adding an empty .appignore file (like in the 'swagger' and 'console_loader' folders), these apps get ignored.

  3. Once OpenRemote is deployed and you open the app, on first launch the app asks for 'App Domain', 'Select an app' and 'Enter the Realm'. If you are e.g. hosting an OpenRemote instance and Realm at https://yourhost.com/manager/?realm=yourrealm use the following: 'App Domain' is 'yourhost.com', App is 'manager' or 'insights' and 'Realm' is 'yourrealm'. Switching between domains, apps and realms can be done by long-pressing the app icon on your home screen.

Using the mobile apps on OpenRemote hosted environments​

You also can use the app for domains hosted by OpenRemote, e.g. the demo environment:

Use the OpenRemote app on the App Store and Google Play to access the demo and try out rules with push notification. Passwords are identical to the Realm names. Note that you have to create the rules while logged in on desktop.

Once you come to the login page, you are accessing the Manager UI or Insights dashboards and seeing the mobile version. Switching between domains, apps and realms can be done by long-pressing the app icon on your home screen.

Building your own mobile apps​

As part of building your own app, using our library of web components, you can use the OpenRemote consoles to leverage functionality of mobile devices, e.g. enable push notifications, use the built-in QR reader, or use geofences. Check out the links below and the code itself if you want to know more.

See Also​