librenms-librenms/doc/Support/Environment-Variables.md
VVelox 06b85f5b07 docs: more md linting (#10371)
* clean 1-Minute-Polling.md formatting

* cleanup formatting for Adding-a-Device.md

* clean up formatting of Cleanup-options.md

* cleanup formatting some for CLI-Tools.md

* cleanup formatting for Syslog.md and Configuration.md

* cleanup formatting for Device-Sensors.md

* cleanup formatting for Device-Troubleshooting.md

* cleanup Discovery Support.md

* cleanup Environment-Variables.md

* cleanup Example-Hardware-Setup.md and FAQ.mg

* update Features.md, Install Validation.md, Perfermance.md, Poller Support.md, and index.md

* cleanup Remote-Monitoring-VPN.md, SNMP-Configuration-Examples.md, and SSL-Configuration.md

* lots of updates for Installation docs

* more installation doc cleanup

* more formatting cleanup

* clean Work-Map.md up some
2019-07-18 21:25:53 -05:00

1.3 KiB

path: blob/master/doc/

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