LibreNMS and Oxidized
by bCloud LLC
Version 26.9.1 + Free Support on Ubuntu 26.04
LibreNMS is an open-source, auto-discovering network monitoring platform that tracks the health and performance of network devices, servers, and services using SNMP. Oxidized is an open-source network device configuration backup tool that automatically collects and versions device configurations. This offer provides both tools pre-integrated on a single virtual machine, so network teams can monitor devices and back up their configurations from one deployment.
Features of LibreNMS and Oxidized:
- LibreNMS automatically discovers and monitors network devices such as routers, switches, firewalls, and servers using SNMP.
- It provides performance graphs for bandwidth, CPU, memory, storage, and uptime.
- It supports alerting, device inventory, port monitoring, and an API for integration with other systems.
- Oxidized automatically backs up network device configurations and keeps a version history of every change.
- Oxidized supports a wide range of network operating systems including Cisco, Juniper, MikroTik, and Fortinet devices.
- LibreNMS and Oxidized run in Docker containers, with the integration between them configured through the LibreNMS API.
- Suitable for network monitoring, capacity planning, change tracking, and configuration backup workflows.
Usage instructions:
$ sudo su
$ cd /opt/librenms-oxidized
$ sudo chown LibreNMS:LibreNMS /opt/librenms-oxidized/.env
$ sudo chmod 600 /opt/librenms-oxidized/.env
$ sudo docker compose config -q
$ sudo docker compose up -d
$ sudo docker compose ps
# Open the LibreNMS web interface and complete the setup wizard
# to create your admin user:
http://<server-ip>:8000/
# To Create User admin:
$ sudo docker exec -it -u librenms librenms lnms user:add myadmin -r admin -e your-email@example.com(change according to your requirements)
# Add a device in LibreNMS:
# Devices -> Add Device (enter device IP and SNMP community)
# Connect Oxidized to LibreNMS:
# 1. In LibreNMS, open your user menu -> API Settings -> Create API access token
# 2. Add the token and your network device login to the Oxidized config:
$ nano /opt/librenms-oxidized/oxidized/config
# (replace CHANGE_ME_LIBRENMS_API_TOKEN, CHANGE_ME_DEVICE_USER, CHANGE_ME_DEVICE_PASS)
# 3. Enable the Oxidized integration in LibreNMS:
$ sudo docker compose exec --user librenms librenms lnms config:set oxidized.enabled true
$ sudo docker compose exec --user librenms librenms lnms config:set oxidized.url http://oxidized:8888
$ sudo docker compose exec --user librenms librenms lnms config:set oxidized.features.versioning true
$ sudo docker compose exec --user librenms librenms lnms config:set oxidized.default_group default
# 4. Restart Oxidized:
$ sudo docker compose restart oxidized
##To check oxidized version:
$ sudo docker inspect librenms/librenms:latest --format '{{index .Config.Labels "org.opencontainers.image.version"}}'
$ sudo docker compose exec -T oxidized oxidized --version
Note: Oxidized backs up configurations of network devices (routers, switches, firewalls). It requires at least one supported network device to be added in LibreNMS. Allow inbound access to ports 8000 and 8888 only from trusted IP addresses.
Disclaimer: LibreNMS and Oxidized functionality depends on the installed version, device SNMP and SSH configuration, network connectivity, user permissions, and deployment environment. Users should change default credentials, configure regular backups, restrict network access, and validate monitoring and backup workflows before using it in production environments.