How to Install LibreNMS on Void Linux

LibreNMS is a free and open-source, powerful network monitoring tool that allows you to monitor servers, network devices, and other infrastructure components, providing real-time visibility and alerting on their status.

Void Linux is a rolling-release, lightweight, and independent Linux distribution that features a binary package manager and uses runit as its default init system. In this tutorial, we will walk you through the steps of installing LibreNMS on Void Linux.

Prerequisites

Before you proceed, ensure that you have the following:

  • A running instance of Void Linux with administrative privileges
  • An active internet connection

Step 1: Update the System

It is always good practice to update your system before installing any new packages. You can do this by running the following command:

sudo xbps-install -Syu

Step 2: Install Apache, PHP, and MySQL

LibreNMS requires a web server (Apache) and a database server (MySQL) to function correctly. To install Apache, PHP, and MySQL on Void Linux, run the following command:

sudo xbps-install -S apache php mysql

Step 3: Install LibreNMS

To install LibreNMS on Void Linux, we will use the Composer package manager. First, install Composer by running the following command:

sudo xbps-install -S composer

Next, navigate to your web server's document root directory (usually /srv/http/) and clone the LibreNMS repository:

cd /srv/http/
sudo git clone https://github.com/librenms/librenms.git

After that, install the LibreNMS dependencies by running the following command:

cd librenms
sudo composer install --no-dev

Finally, run the LibreNMS installation script:

sudo ./scripts/install.sh

This will prompt you to answer a series of questions, including your MySQL database details and LibreNMS admin user credentials. Once the installation is complete, you should be able to access LibreNMS by navigating to http://YOUR_SERVER_IP/librenms in your web browser.

Step 4: Configure Apache

By default, Apache on Void Linux will only serve up static content from the /srv/http/ directory. To enable PHP and allow LibreNMS to function correctly, you need to modify the Apache configuration.

Create a new file in /etc/httpd/conf/extra/ called librenms.conf:

sudo nano /etc/httpd/conf/extra/librenms.conf

Add the following content to the file:

Alias /librenms /srv/http/librenms/

<Directory /srv/http/librenms>
    Options FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

<FilesMatch \.php$>
    SetHandler "proxy:unix:/run/php-fpm/php-fpm.sock|fcgi://localhost"
</FilesMatch>

Save and exit the file.

Next, edit /etc/httpd/conf/httpd.conf and uncomment the following lines:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so
Include conf/extra/librenms.conf

Save and exit the file.

Finally, start and enable the Apache and PHP-FPM services:

sudo ln -s /etc/sv/httpd /var/service/
sudo ln -s /etc/sv/php-fpm /var/service/

Conclusion

You have successfully installed and configured LibreNMS on Void Linux. It's now time to start monitoring your network devices and infrastructure!