How to Install LibreNMS on macOS

Introduction

LibreNMS is a popular open-source network monitoring system. It provides comprehensive monitoring and alerting services for network devices and infrastructure. In this tutorial, you will learn how to install LibreNMS on macOS.

Prerequisites

• A macOS computer with administrative rights.
• A working internet connection.

Step 1: Installing Xcode Command-Line Tools

Open the Terminal app from your Applications > Utilities folder. Type the following command to install Xcode Command-Line Tools:

xcode-select --install

A pop-up window will appear asking you to install Xcode Command-Line Tools. Click "Install" to continue.

Step 2: Installing Homebrew

Homebrew is a popular package manager for macOS. Type the following command in the Terminal to install Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Press "Return" when prompted to continue with the installation.

Step 3: Installing Required Packages

LibreNMS requires several packages to be installed on your system. Type the following command in the Terminal to install them:

brew install mariadb nginx [email protected] rrdtool composer

Step 4: Securing the MySQL Installation

LibreNMS requires a MySQL database to store its data. Run the following commands to start the MySQL installation and secure it:

sudo mysql_install_db
sudo mysql_secure_installation

During the installation, you will be prompted to set a root password for the MySQL server.

Step 5: Creating a LibreNMS User

Create a new user for LibreNMS to run as with the following command:

sudo useradd librenms -d /opt/librenms -M -r
sudo usermod -a -G librenms _www

Step 6: Downloading and Installing LibreNMS

Download the latest version of LibreNMS from the official website using the following command:

sudo curl -o /opt/librenms.tar.gz https://www.librenms.org/download/latest-stable.tar.gz

Extract the file using the following command:

sudo tar -zxvf /opt/librenms.tar.gz -C /opt/

Run the following command to set the correct file permissions:

sudo chown -R librenms:librenms /opt/librenms
sudo chmod -R 775 /opt/librenms

Step 7: Configuring Nginx

Create a new Nginx configuration file with the following command:

sudo nano /usr/local/etc/nginx/servers/librenms.conf

Add the following configuration to the file:

server {
    listen 80;
    server_name librenms.local;
    root /opt/librenms/html;

    access_log /usr/local/var/log/nginx/librenms-access.log;
    error_log /usr/local/var/log/nginx/librenms-error.log;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ .php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Save and close the file by pressing "Control + X", then "Y", and finally "Return".

Step 8: Configuring PHP

Open the PHP configuration file with the following command:

sudo nano /usr/local/etc/php/7.3/php.ini

Search for the following line:

;date.timezone =

Uncomment the line and set the timezone to your local timezone.

date.timezone = America/Los_Angeles

Save and close the file.

Step 9: Starting the Services

Start the required services with the following commands:

sudo brew services start mariadb
sudo brew services start nginx
sudo brew services start [email protected]

Step 10: Configuring LibreNMS

Navigate to http://localhost/install.php in your browser to start the LibreNMS web installer.

Follow the instructions on the screen to configure LibreNMS. When prompted for the database settings, use the following values:

• Database host: localhost
• Database name: librenms
• Database username: root
• Database password:

After the installation is complete, navigate to http://localhost/ to access LibreNMS.

Conclusion

Congratulations! You have successfully installed LibreNMS on macOS. You can now use LibreNMS to monitor your network devices and infrastructure.