Available on all plans
Cloud and self-hosted deployments
System Admins for both self-hosted and Cloud Mattermost workspaces can manage Mattermost configuration using the System Console. For self-hosted deployments, admins can additionally edit the
Mattermost requires write permissions to the
config.json file; otherwise, configuration changes made within the System Console will have no effect.
Mattermost configuration settings are organized into the following categories within the System Console:
In self-hosted Mattermost deployments, configuration settings are maintained in the
config.json configuration file, located in the
mattermost/config directory, or stored in the database. System Admins managing self-hosted workspaces can also modify the
config.json file directly using a text editor.
Configuration in database
From Mattermost v5.10, self-hosted system configuration can be stored in the database. This changes the Mattermost binary from reading the default
config.json file to reading the configuration settings stored within a configuration table in the database. See the Mattermost database configuration documentation for migration details.
You can use environment variables to manage Mattermost configuration. Environment variables override settings in
config.json. If a change to a setting in
config.json requires a restart to take effect, then changes to the corresponding environment variable also require a server restart.
The “config watcher”, the mechanism that automatically reloads the
config.json file, has been deprecated in favor of the mmctl config reload command that you must run to apply configuration changes you’ve made. This improves configuration performance and robustness.
Deprecated configuration settings
See the deprecated configuration settings documentation for details on all deprecated Mattermost configuration settings that are no longer supported.