mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
06b85f5b07
* 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
65 lines
1.3 KiB
Markdown
65 lines
1.3 KiB
Markdown
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.
|
|
|
|
```dotenv
|
|
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.
|
|
|
|
```dotenv
|
|
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)
|
|
|
|
```dotenv
|
|
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.
|
|
|
|
```dotenv
|
|
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.
|
|
|
|
```dotenv
|
|
APP_DEBUG=true
|
|
```
|