io.Connect Desktop is highly configurable. You can apply custom system-wide, as well as app-specific settings. Among the configurable features are system settings, app settings, io.Connect Windows, io.Connect Themes, logging and more.


The following JSON schemas describe the available options for configuring io.Connect Desktop:

⚠️ Note that a JSON schema for the logging configuration found in the logger.json file isn't available, as the io.Connect Desktop logging mechanism is based on log4js-node. The logging configuration provided in the logger.json file is identical to the log4js-node configuration as described in the log4js-node API documentation.


All configuration files for io.Connect Desktop can be found in %LocalAppData%/ Desktop/Desktop/config (mainly in the form of JSON files). There you can find the system.json file for system-wide configurations, the stickywindows.json file for configuring the default behavior of io.Connect Windows, the themes.json file for configuring the io.Connect Desktop Themes, the channels.json file for configuring the io.Connect Channels, and the logger.json file for configuring the logging for io.Connect Desktop.

In the \apps folder of the same directory, you can find the configuration files for the apps bundled with the io.Connect Desktop installer.

You can add an app definition file in the %LocalAppData%/ Desktop/UserData/<ENV>-<REG>/apps folder, where <ENV>-<REG> represents the environment and region of io.Connect Desktop (e.g., DEMO-INTEROP.IO). This way, your files won't be erased or overwritten, in case you decide to upgrade or change your io.Connect Desktop version.

⚠️ Note that the app definitions are monitored at runtime, so you don't need to restart io.Connect Desktop when you change something. The location of the app definition folder can be changed from the system.json. For more information, see the system.json configuration schema.