Skip to content

matomo-org/plugin-EnvironmentVariables

4.x-dev
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

Matomo EnvironmentVariables Plugin

Description

Override any Matomo config with environment variables. To overwrite any setting simply specify an environment variable in the following format:

MATOMO_$CATEGORY_$SETTING

For example to overwrite the database username and password which is usually defined in the config/config.ini.php like this:

[database]
username = "root"
password = "secure"

using environment variables like this:

export MATOMO_DATABASE_USERNAME=root
export MATOMO_DATABASE_PASSWORD=secure

Known issues:

  • Configuration arrays are currently not supported, for example you cannot define which Plugins[] should be loaded.
  • At some point your Matomo may save/write the config file, for example when changing certain settings through the UI such as the trusted hosts. In this case, the currently read environment variables will be saved in the config file.
  • If this plugin is used with PHP-FPM, for example in combination with NGINX, PHP-FPM will not have access to the environment variables by default. The pool used by PHP-FPM must either explicit define which ENVs should be exposed, or set clear_env = no in /etc/php7/php-fpm.f/<pool>.conf.

About

Allows you to specify Matomo config in environment variables instead of the config file.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages