You are currently browsing legacy 4.1 version of documentation. Click here to switch to the newest 5.1 version.

We can help you with migration to the latest RavenDB

Contact Us Now
see on GitHub

Configuration Options

RavenDB is Safe by Default which means its set of options is configured for the best safety.
However, these options can be manually configured in order to accommodate different server behavior.

Environment Variables

Configuration can be adjusted using environment variables. Server is going to pick up all environment variables preceded by RAVEN_ prefix and apply their values to specified configuration keys. All period . characters in configuration keys should be replaced with an underscore character (_) when used in environment variables.




The settings.json file which can be found in the same directory as the server executable can also be used to change the configuration of the server. The file is read and applied on the server startup only. It is created when running the server for the first time from the settings.default.json file.


    "ServerUrl": "",
    "Setup.Mode": "None"


Changes in settings.json override the environment variables settings.

JSON Arrays

All configuration options that support multiple values (for example strings separated by ;) can be configured via regular JSON array e.g. Security.WellKnownCertificates.Admin

    "ServerUrl": "",
    "Setup.Mode": "None",
    "Security.WellKnownCertificates.Admin" : [ "297430d6d2ce259772e4eccf97863a4dfe6b048c", "e6a3b45b062d509b3382282d196efe97d5956ccb" ]

Command Line Arguments

The server can be configured using command line arguments that can be passed to the console application (or while running as a deamon).


./Raven.Server --Setup.Mode=None


These command line arguments override the settings of environment variables and the settings.json. More details about Command Line Arguments can be found here.