Skip to content

Tutorial: Configure the mobile app

Martin Peeters edited this page Oct 3, 2023 · 9 revisions

T.B.D.

Here we will explain how to configure your apps to be used in the OpenRemote mobile app. You have the option to show/not show on mobile, and for which realms the app is available. Also you can define whether realm options are shown as a list or input field (if you don't want to reveal all available realms).

Mobile apps can be found in the Apple Appstore and Google Playstore

The first time opening the app you will be asked three things: 'App Domain', 'Select an app' and 'Enter the Realm'. Switching between domains, apps and realms can be done by long-pressing the app icon on your home screen. If you are hosting an OpenRemote instance at https://yourhost.com use the following: 'App Domain' is 'yourhost.com'.

Configure apps which can be selected

Apps can be hidden from the consoles using one of the following methods:

  • Either placing an empty .appignore file in the folder of the platform- or custom app. For example: /ui/app/custom/.appignore
  • Or, customizing the console_config.json file, by changing the allowedApps field to the correct list (String[]) of apps.
    For example: { allowedApps: ['manager', 'custom'] }

If only one App is present, it will automatically skip the 'app selection'-menu.

Configure for which realms the app can be used

T.B.D.

  • shortlist available realms
  • show as dropdown list or input field
  • if only one realm, skip step

See Also

Clone this wiki locally