How to Install LibreNMS on nixOS Latest

LibreNMS is an open-source, community-driven network monitoring system that aims to provide a comprehensive solution for monitoring a wide range of devices and applications. This tutorial will guide you through the steps required to install LibreNMS on nixOS Latest.

Requirements

Before proceeding with this tutorial, make sure you have the following:

nixOS Latest installed on your system
Root access or sudo privileges
Internet connectivity

Step 1: Install Required Packages

Open your terminal and update your nixOS system by running the following command:

sudo nix-channel --update
sudo nixos-rebuild switch

Now, install the required packages for LibreNMS by executing the following command:

sudo nix-env -iA nixos.php nixos.composer nixos.mariadb

Step 2: Download and Install LibreNMS

Create a directory where you want to install LibreNMS and navigate to it:

sudo mkdir /opt/librenms
cd /opt/librenms

Now, download the latest version of LibreNMS using Git by running the following command:

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

Set the correct permissions for the LibreNMS directory:

sudo chown -R www-data:www-data /opt/librenms
sudo chmod 777 /opt/librenms/bootstrap/cache /opt/librenms/storage

Install the required PHP dependencies using Composer:

sudo composer install --no-dev

Step 3: Configure the Database

Next, we need to configure the database for LibreNMS. To do this, log in to the MariaDB server:

sudo mariadb -u root -p

Create a new database and user for LibreNMS:

CREATE DATABASE librenms CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'your-password';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost' IDENTIFIED BY 'your-password';
FLUSH PRIVILEGES;
exit

Step 4: Configure PHP

Open the PHP configuration file in your favorite text editor:

sudo nano /etc/php.ini

Add the following lines to the end of the file:

date.timezone = America/New_York
memory_limit = 512M
cgi.fix_pathinfo=0

Save and close the file.

Step 5: Configure Apache

Create a new Apache configuration file for LibreNMS:

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

Add the following configuration:

<VirtualHost *:80>
 ServerName librenms.example.com
 DocumentRoot /opt/librenms/html/
 <Directory "/opt/librenms/html/">
  AllowOverride All
  Options FollowSymLinks MultiViews
  Require all granted
 </Directory>
</VirtualHost>

Save and close the file.

Step 6: Enable Services

Enable and start the required services:

sudo systemctl enable mariadb
sudo systemctl start mariadb
sudo systemctl enable php-fpm
sudo systemctl start php-fpm
sudo systemctl enable httpd
sudo systemctl start httpd

Step 7: Complete the Installation

Now, open your web browser and navigate to http://librenms.example.com/install.php to complete the installation.

Follow the on-screen instructions to set up LibreNMS, including connecting to the database and setting up the administrator account.

Once the installation is complete, delete the install.php file:

sudo rm /opt/librenms/html/install.php

Finally, navigate to http://librenms.example.com/ to access your LibreNMS dashboard.

Congratulations! You have successfully installed LibreNMS on nixOS Latest.