Customizing Configuratron Configuration

Customizing Configuratron Configuration

Configuratron allows you to create a configuration file with settings that override default settings.

When you first install Configuratron, it is set to automatically start (as a Windows Service) using its internal default settings. Examples: the default localhost hostname and 2403 port number, and the embedded RavenDB database location.

To override these default settings:

1. Stop the Configuratron service.
2. Locate/create a configuration file named Configuratron.exe.config in the Configuratron installation folder.
3. Edit the configuration file and add the relevant settings to the section.
4. Start the Configuratron service.

Sample configuration file

• File name: to_be_decided.exe.config
• File path: C:\Program Files (x86)<to_be_decided> (default Configuratron installation folder)

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<configuration>
  <appSettings>
      <add key="Configuratron/Hostname" value="foo.bar.com" />
      <add key="Configuratron/Port" value="2403" />
      <add key="Configuratron/DbPath" value="y:\path_to_raven_db_folder" />
      <add key="Configuratron/LogPath" value="y:\path_to_logs_folder" />
      ...
  </appSettings>
</configuration>

Configuration Considerations

Configuration Options

• Configuratron/LogPath (string)The path for the Configuratron logs. Default: %SystemDrive%\ProgramData\Configuratron\logs
• Configuratron/Port (int) The port to bind the embedded http server. Default: 2403.
• Configuratron/Hostname (string) The hostname to bind the embedded http server to, modify if you want to bind to a specific hostname, eg. foo.bar.com. Default: localhost
• Configuratron/DbPath (string) The path where the internal RavenDB is located. Default: %SystemDrive%\ProgramData\Configuratron\Data