The Database Settings View lists all the database and server configuration keys & values.
In this view, you can only edit the database-scope configuration keys. Server-scope keys are read-only.
To edit a server-scope key follow any of the available options listed in the Configuration overview article.
After editing & saving a configuration key, the change does not take effect
until the database is reloaded.
Do not modify the database settings unless you are an expert and know what you're doing.
A 'yellow' entry is a key whose value was customized by the user.
A 'green' entry is a key holding a default value that was not modified.
This column shows the Effective Value for each key.
It is the current value of the key - either the default value or a customized value if modified by the user.
This column indicates the value's Origin:
Default - This is the default value, no customized value was set.
Server - Value is configured in the settings.json file (customized by the user), overriding the default settings.
Database - Value is configured in the database record (customized by the user), overriding the server & default settings.
Edit Database Settings
Only the database scope configuration keys can be edited from this view.
Configuration keys that relate only to the server scope are edited in the
and can only be viewed here.
Once you save the changes made in this view, all modifications are saved into the
However, in order for those changes to be in effect, the database must be reloaded.
See How to Reload the Database.
Figure 2: Edit Database Settings
Type a keyword here to filter the configuration keys.
For easier navigation, the configuration keys are divided into Categories
according to the related RavenDB feature.
This column lists the Configuration Keys in the selected Category.
This column lists the current Value set for the key.
The lock icon indicates that this key is server scoped and can not be modified here.
It can be edited only from the settings.json file
located in your RavenDB executable folder.
Toggle to override the current value of this key.
Use the edit box to customize the value.
Click Set default to display the default value of this key in the edit box.
This default value will override the current value.
Save the changes made to the settings.
All changes will immediately be written to the database record.
However, in this view, the changes will appear as pending and will not be in effect until the
database is reloaded.
See How to Reload the Database.
Database Settings View with Pending Values
Figure 3: Database Settings with Pending Values
After editing the configuration keys and saving your changes, the main database settings
view slightly changes.
The Effective Value column now becomes Effective Value in Use.
It is the key value that is currently being used (not the new customized value).
The Origin column is replaced with the Pending Value column.
This shows your new customized value.
This pending value will be applied and replace the Effective Value once the database is reloaded.
How to Reload the Database
There are a few ways to reload a database:
Restart RavenDB on all nodes.
The database settings configuration will become effective for each node that is restarted.
Disable and then re-enable the database from the Database List View in the Studio, see image below.
This will reload the database on all the cluster nodes immediately.
Figure 3: How to Reload the Database
Navigate to the Database List View.
Click Disable to disable the database. This makes the database inaccessible and halts
all processes such as indexing. Once the database is disabled, this button changes to Enable.
Click on it again to enable the database.