mirror of
https://github.com/librenms/librenms.git
synced 2024-09-22 19:08:15 +00:00
1ee2e8e0e0
* 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
61 lines
1.3 KiB
Markdown
61 lines
1.3 KiB
Markdown
# 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.
|
|
|
|
```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
|
|
```
|