LibreNMS requires a MariaDB/MySQL database server. You can configure
debops.mariadb, either on the
same host as LibreNMS, or remotely.
The SNMP protocol is used to gather metrics from devices. Network switches / routers should
have an option to enable SNMP in their configuration, on Debian hosts you can use the
debops.snmpd role to install and configure
debops.librenms role will automatically use the username and password created
debops.snmpd role as SNMP v3 credentials.
LLDP/xDP protocol is used for device autodiscovery and network map generation.
debops.snmpd role will automatically install a suitable LLDP daemon for you.
If you enable SNMP/LLDP on the LibreNMS host as well as other hosts, after
installation LibreNMS should automatically detect and add nearby devices when
it adds its own host to the database.
After installation, the LibreNMS webpage should be available at the
You can access the LibreNMS CLI commands by switching to the
user, for example via
sudo. You can find the installation in
~/sites/public directory by default.
This is a list of role variables which you are most likely want to define in Ansible’s inventory to customize LibreNMS:
- List of SNMP v1/v2c communities LibreNMS should use to authenticate to
network devices. By default it contains the community
- List of admin accounts created in the LibreNMS database. Passwords are stored
automatically in the
secret/directory, see the
debops.secretrole for more details. By default an admin account based on the
ansible_ssh_uservariable is created.
- List of devices to add to the LibreNMS database. Specify FQDN hostnames or IP
addresses. By default LibreNMS will add its own host, based on
To install and configure LibreNMS on a host, you need to add the host to the
[debops_librenms] Ansible host group: