librenms-librenms/doc/Support/Environment-Variables.md
Tony Murray 421bcb030d Force root url if set by user (#9266)
* Force root url if set by user
If user sets APP_URL, force the root url to that.  Empty strings result in default behavior.
Fix some of the urls in the laravel templates.

* Docs update

* Add base_url
2018-10-02 07:56:13 -05:00

1.2 KiB

Environment Variables

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