LibreNMS
| Description / name | Input element |
|---|---|
| Container Registry | |
| Container Configuration Root Path | |
| Timezone | |
| User ID | |
| Group ID | |
| LibreNMS Host Port |
LibreNMS is an autodiscovering PHP/MySQL/SNMP based network monitoring which includes support for a wide range of network hardware and operating systems including Cisco, Linux, FreeBSD, Juniper, Brocade, Foundry, HP and many more.
| Port | 8080 |
| Registry | ghcr.io/daemonless/librenms |
| Daemonless | daemonless/librenms |
| Source | www.librenms.org |
| Website | www.librenms.org |
Version Tags
| Tag | Description | Best For |
|---|---|---|
latest / pkg |
FreeBSD Quarterly. Uses stable, tested packages. | Production stability. |
pkg-latest |
FreeBSD Latest. Rolling package updates. | Staying current. |
Parts
| Service | Image | Role | |
|---|---|---|---|
| librenms | ghcr.io/daemonless/librenms:latest |
docs | |
| librenms-mariadb | ghcr.io/daemonless/mariadb:latest |
docs |
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.
Deployment
1. Save as .env and fill in what is empty:
2. Save as compose.yaml:
Then run podman-compose up -d.
Access at: http://localhost:8080
Interactive Configuration
Parameters
Environment Variables
| Variable | Default | Description |
|---|---|---|
PUID |
1000 |
User ID for the application process |
PGID |
1000 |
Group ID for the application process |
TZ |
UTC |
Timezone for the container |
DB_HOST |
127.0.0.1 |
Where LibreNMS finds MariaDB (fjord sets this; 127.0.0.1 on host networking) |
DB_PORT |
3306 |
MariaDB port |
DB_DATABASE |
librenms |
Database name |
DB_USERNAME |
librenms |
Database user |
DB_PASSWORD |
<DB_PASSWORD> |
Password for the librenms database user |
ADMIN_USER |
admin |
LibreNMS admin account, created on first start |
ADMIN_PASSWORD |
<ADMIN_PASSWORD> |
Password for that admin account, used as given (LibreNMS's own rules apply to passwords changed later in its UI) |
APP_URL |
`` | Address you open LibreNMS at, e.g. http://192.168.1.10:8080 (used in links it sends) |
MYSQL_ROOT_PASSWORD |
<MYSQL_ROOT_PASSWORD> |
MariaDB root password (the database password unless set) |
CONFIG_LOCATION |
/containers/librenms/config |
Host folder for LibreNMS data: settings, RRD files, logs |
DB_DATA_LOCATION |
/containers/librenms/mariadb |
Host folder for the MariaDB data |
Volumes
| Path | Description |
|---|---|
/config |
Persistent data: .env, RRD files, logs, storage |
Ports
| Port | Protocol | Description |
|---|---|---|
8080 |
TCP | Web UI |
Networking: both services ship on network_mode: host, and LibreNMS
reaches MariaDB at 127.0.0.1. MariaDB then listens on the host's port 3306,
so set strong passwords. Installed through fjord onto a network, the
database moves to the stack's own private network instead and is found by
name (DB_HOST).
First login
Set ADMIN_USER and ADMIN_PASSWORD and the admin account is created on
first start, with the password exactly as given. LibreNMS's own rules for
passwords (at least 8 characters, none from a known data leak) apply to
passwords changed later in its UI, not to this one.
Implementation Details
- Architectures: amd64
- User:
bsd(UID/GID set via PUID/PGID). Defaults to1000:1000. - Base: Built on
ghcr.io/daemonless/base(FreeBSD 15.1).
Need help? Join our Discord community.