The TurnkeySettings.xml is a settings file in the appdata catalog of the Turnkey application.

This file holds a number of settings that control the behavior of your application.

The TurnkeySettings.xml is recreated for your application by the portal.mdriven.net when you press SendSettingsAndRestart. The TurnkeySettings is thus normally a generated file based on the settings you have given your application in portal.mdriven.net.

When you have a standalone or local installation that the portal cannot reach you will need to supply this file yourself.

Starting from July 2019 we allow for a TurnkeySettingsOverride.xml file to be created.

This file will not be touched / created by portal. The TurnkeySettingsOverride.xml will be read after the TurnkeySettings.xml file is read.

The use-case for TurnkeySettingsOverride.xml is that you may have settings local to your application that the portal does not know about - like experimental or new settings not available in portal.

One such example at the time of writing is the ORCID authentication settings that we suspect will be used by very few and thus should not consume portal space and should not increase portal complexity for the user.