Skip to content

Configurator Mode

Jordy Witteman edited this page Oct 29, 2025 · 2 revisions

Introduction

Starting with Support App 3.0, the easiest way to configure it is using its built-in Configurator Mode which allows you to visualize the app, quickly try different layouts, iterate on previous configurations and export the result to a property list of .mobileconfig file to directly upload into your Device Management Service.

What is Configurator Mode

Configurator Mode is a special mode in Support App which puts the app in an edit mode where administrators can add/remove rows, add/edit/remove items or configure other settings. When enabled, it loads the current local configuration or managed configuration. It is designed to make configuring Support App as easy as possible and compatible with any Device Management Service.

How to enable Configurator Mode

To enable Configurator Mode, right-click or option-click on the Support App menu bar icon and choose "Configurator Mode". Support App will open in Configurator Mode in editable state.

enable_configurator_mode configurator_mode_complete

Where are settings saved

Configurator Mode is built on UserDefaults and saves the configuration to the user's preference: /Users/USERNAME/Library/Containers/nl.root3.support/Data/Library/Preferences/nl.root3.support.plist. When enabled, it loads the settings hierarchically from UserDefaults or combines these. If a setting is managed by a Configuration Profile, this takes precedence over a value set locally. When there are no managed settings at all, Support App only uses local settings.

Item configuration

configurator_mode_item

Other settings

configurator_mode_settings

Exporting configuration

There are two ways to export the configuration from Configurator Mode:

  • Property List: an XML file which can be used in Device Management Services accepting property lists for configuring 3rd party applications. Often recognized when you also have to specify a preference domain. Use nl.root3.support as value.
  • Configuration Profile: a file Configuration Profile or .mobileconfig which can often be uploaded directly into a Device Management Service without any further configuration.
configurator_mode_export

Limitations

  • For security reasons, Privileged Scripts cannot run when configured locally. This is to prevent (standard) users from calling scripts with elevated privileges.

Clone this wiki locally