LibreNMS

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
Source	https://www.librenms.org
Website	https://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

Prerequisites

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.

Deployment

Podman Compose

1. Save as .env and fill in what is empty:

# LibreNMS for FreeBSD (Daemonless)
# Copy to .env and edit.

# Where data lives on the host
CONFIG_LOCATION=/containers/librenms/config
DB_DATA_LOCATION=/containers/librenms/mariadb

# Database password: required, no default. On host networking MariaDB
# listens on this host's port 3306, root included.
DB_PASSWORD=
# MariaDB root password; the database password unless set.
# MYSQL_ROOT_PASSWORD=

# Admin account created on first start, with the password exactly as given.
ADMIN_USER=admin
ADMIN_PASSWORD=

# Optional: the address you open LibreNMS at, used in the links it sends.
# APP_URL=http://192.168.1.10:8080

# Timezone (TZ identifier)
# TZ=UTC

2. Save as compose.yaml:

name: librenms

services:
  librenms:
    image: ghcr.io/daemonless/librenms:latest
    container_name: librenms
    network_mode: host
    restart: always
    depends_on:
      - librenms-mariadb
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=${TZ:-UTC}
      # 127.0.0.1 on host networking; fjord sets the database's name when it
      # puts the stack on a network (x-daemonless.hostnames).
      - DB_HOST=${DB_HOST:-127.0.0.1}
      - DB_PORT=3306
      - DB_DATABASE=librenms
      - DB_USERNAME=librenms
      - DB_PASSWORD=${DB_PASSWORD}
      - ADMIN_USER=${ADMIN_USER}
      - ADMIN_PASSWORD=${ADMIN_PASSWORD}
      # Optional: the address LibreNMS puts in the links it sends (alerts).
      - APP_URL=${APP_URL:-}
    volumes:
      - ${CONFIG_LOCATION}:/config
    # Ignored on host networking; used when fjord puts the stack on a bridge.
    ports:
      - 8080:8080

  librenms-mariadb:
    image: ghcr.io/daemonless/mariadb:latest
    container_name: librenms-mariadb
    network_mode: host
    restart: always
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=${TZ:-UTC}
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:-${DB_PASSWORD}}
      - MYSQL_DATABASE=librenms
      - MYSQL_USER=librenms
      - MYSQL_PASSWORD=${DB_PASSWORD}
    volumes:
      - ${DB_DATA_LOCATION}:/config

Then run podman-compose up -d.

Access at: http://localhost:8080

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.

Architectures: amd64 User: bsd (UID/GID via PUID/PGID, defaults to 1000:1000) Base: FreeBSD 15.1

---

Need help? Join our Discord community.