librenms/doc/Support/Environment-Variables.md
Neil Lathwood 1ee2e8e0e0
Updated to use new theme for docs site (#9320)
* Updated to use new theme for docs site

* Updated theme location

* Removed librenms.css

* Updated index page + re-added librenms.css

* Use built in theme modification

* flexbox grid, dump bootstrap

* tidy up things

* Added path and updated deploy script + mkdocs config

* Removed db schmea changes

* Updated to install python/pip 3

* Removed pip3 install

* Pip3 install

* Updated deploy-docs

* Updated deploy-docs
2018-10-27 23:04:34 +01:00

1.3 KiB

Environment Variables

path: blob/master/doc/

LibreNMS allows certain settings to be set via the environment or through the .env file.

Database

Set the variables to connect to the database. The default values are shown below.

DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=librenms
DB_USERNAME=librenms
DB_PASSWORD=
DB_SOCKET=

Trusted Reverse Proxies

A comma separated list of trusted reverse proxy IPs or CIDR.

For legacy reasons the default is '*', which means any proxy is allowed. '**' means trust any proxy up the chain.

APP_TRUSTED_PROXIES=192.168.1.0/24,192.167.8.20

Base url

Set the base url for generated urls. Do not set this if it is not needed.

You may need to set this when using reverse proxies combined with a subdirectory.

Generally, LibreNMS will make correct URLs (especially if you have set up your proxy variables correctly)

APP_URL=http://librenms/

User / Group

The user and group that LibreNMS should operate as. Group will default to the same as the user if unset.

LIBRENMS_USER=librenms
LIBRENMS_GROUP=librenms

Debug

Increases the amount of information shown when an error occurs.

WARNING: This may leak information, do not leave enabled.

APP_DEBUG=true