LibreNMS - Monitor all your devices easily!

Introduction

This tutorial will guide you through the process of using LibreNMS to monitor your devices easily, whether you are running a HomeLab or managing a corporate environment. By implementing LibreNMS with Proxmox, you can efficiently track the health of multiple devices with minimal resource usage.

Step 1: Setting Up Proxmox

• Install Proxmox: Download the Proxmox ISO from the official website and create a bootable USB drive.
• Boot from USB: Insert the USB into your server and boot from it. Follow the installation prompts to set up Proxmox.
• Access Proxmox Web Interface: Once installed, access the Proxmox web interface by navigating to https://your-server-ip:8006 in your web browser.

Step 2: Creating a Container for LibreNMS

• Create a New Container:

  1. In the Proxmox interface, click on “Create CT”.
  2. Follow the wizard to set up your container (choose an appropriate template, usually a lightweight Linux distribution).

• Configure Resources:

  • Allocate sufficient CPU and memory resources based on the number of devices you plan to monitor (e.g., 2 CPUs and 2GB RAM is a good starting point).

• Network Configuration:

  • Assign a static IP address to your container to ensure it remains reachable.

Step 3: Installing LibreNMS

• Access the Container: Use the Proxmox console or SSH into your newly created container.

• Update Package Index:

  sudo apt update
  sudo apt upgrade
  

• Install Required Packages:

  sudo apt install git curl
  

• Clone the LibreNMS Repository:

  git clone https://github.com/librenms/librenms.git /opt/librenms
  

• Run the Installation Script:

  • The video mentions a specific script for installation. Use the provided link to download it:

  curl -L -O https://raw.githubusercontent.com/rawIce/LibreNMS-Install/master/install.sh
  chmod +x install.sh
  ./install.sh
  

Step 4: Configuring LibreNMS

• Set Up the Database:

  • Create a MySQL/MariaDB database for LibreNMS. Log into MySQL and run:

  CREATE DATABASE librenms;
  CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'yourpassword';
  GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
  FLUSH PRIVILEGES;
  

• Edit the Configuration File:

  • Navigate to the LibreNMS directory and copy the sample configuration file:

  cp /opt/librenms/config.php.default /opt/librenms/config.php
  

  • Edit config.php to include your database credentials.

Step 5: Adding Devices to Monitor

• Access LibreNMS Web Interface: Open your web browser and navigate to http://your-container-ip.
• Login: Use the default credentials to log in.
• Add Devices:
  • Navigate to the “Devices” section and click on “Add Device”.
  • Enter the IP address or hostname of the device you wish to monitor and configure SNMP settings as required.

Conclusion

You now have a fully functional LibreNMS setup running in a Proxmox container, ready to monitor your devices. Keep an eye on device health and performance through the web interface. For ongoing maintenance, consider setting up alerts and regularly checking for software updates. If you need to scale your monitoring, simply add more devices or create additional containers as needed.