🚀 Welcome to MDriven Learn –  Don’t miss the latest Release Notes.
MDrivenServerOverride

App_Data/MDrivenServerOverride.xml in the MDriven Turnkey application tells Turnkey where its MDriven Server is, and which password to use.

When you need it

  • Not needed when MDriven Server is installed as an application called __MDrivenServer directly below the Turnkey application. That is where Turnkey looks by default: its own address followed by /__MDrivenServer.
  • Needed when MDriven Server is anywhere else – under another name, as a separate site, on another server, or behind a load balancer.

When Turnkey starts, it writes the address it uses to its log: Started with MDrivenServerUrl: … – see Logs.

The file

<?xml version="1.0" encoding="utf-8"?>
<root>
  <MDrivenServerOverride MDrivenServerPWD="the password of user a">https://myserver.example.com/MyAppServer</MDrivenServerOverride>
</root>
  • The element's text is the address of MDriven Server.
  • MDrivenServerPWD is the password of the MDriven Server user a, the account Turnkey uses. Use the password you set in MDriven Server.
  • The file contains a password: make sure only administrators and the application pool user can read it.
  • The Turnkey zip contains an example: App_Data/MDrivenServerOverride - NotInEffect.xml. Only an element directly under <root> is used; the example in <notActive> is ignored.

Other attributes

Attribute Use
SkipSignalR="true" When a Turnkey built with .NET Core connects to an MDriven Server built with .NET Framework: their SignalR versions are incompatible, so turn SignalR off.
PrototypeWithMDrivenDesignerInPath="c:\temp\dummy.modlr" Run Turnkey directly from a model file to prototype, without an MDriven Server.
CopyAssetsTKOnStart="True" / "False" With PrototypeWithMDrivenDesignerInPath: whether AssetsTK next to the model file is copied into the Turnkey application at start. Use False when you develop components in the Turnkey application and do not want them overwritten.

Example for prototyping:

<MDrivenServerOverride PrototypeWithMDrivenDesignerInPath="c:\temp\dummy.modlr" CopyAssetsTKOnStart="True"></MDrivenServerOverride>

You can also have Turnkey load CodeDress from a specific path – see Debug Turnkey generic code.

See also