How to configure MediaWiki¶

MediaWiki’s basic configuration settings are managed using the LocalSettings.php file. While the MediaWiki charm will provide some sensible defaults and also generate some necessary secrets, you may want to customize the configuration of your MediaWiki deployment by providing your own LocalSettings.php file.

Warning

Certain configuration settings, such as database credentials and secrets like $wgSecretKey, are handled entirely by the MediaWiki charm. The settings are applied in such a way that the Charm’s management has greater priority over most manually configured settings.

The MediaWiki charm allows you to configure an arbitrary LocalSettings.php file using juju config.

For example, with a local LocalSettings.php file, you can run the following command to update the charm’s configuration:

juju config mediawiki-k8s local-settings="$(cat ${PATH_TO_LOCAL_SETTINGS_FILE})"

Note

The user-configured LocalSettings.php contents are stored outside the webroot and are not world-readable. This is to minimize the risk of exposing sensitive information. Refer to the security overview for more details.