How to Install LibreNMS on Windows 11
LibreNMS is an open-source network monitoring system that provides a web-based user interface for devices management, performance monitoring, and alerting. In this tutorial, we will explore how to install LibreNMS on a Windows 11 computer.
Prerequisites
Before we get started, make sure you have the following tools and software installed on your computer:
- Windows 11 operating system
- XAMPP or WAMP server
- Composer
Step 1: Download LibreNMS
Visit the official LibreNMS website at http://www.librenms.org and download the latest version of LibreNMS.
Step 2: Install XAMPP or WAMP server
You need a web server and PHP environment to run LibreNMS. XAMPP and WAMP are popular tools that bundle Apache, MySQL, and PHP in one package. Follow the installation steps to install either of the servers on your system.
Step 3: Install Composer
Composer is a dependency manager for PHP that helps to manage packages or libraries required for your project. Download and install Composer from the official website: https://getcomposer.org/
Step 4: Install LibreNMS
Once the installation of all prerequisite software is done, extract the downloaded LibreNMS file and move it to the Apache document root folder (htdocs in case of XAMPP and www in case of WAMP).
Next, change the folder permission to 777 by running the following command from the Windows command prompt:
cd C:\xampp\htdocs\librenms
icacls . /grant Everyone:(OI)(CI)F /T
Save the following changes to the config.php file in C:\xampp\htdocs\librenms\config.php. Add the hostname (IP address) of your server, change the community to your SNMP community (if it differs), and update the database credentials if needed.
$config['db_host'] = 'localhost';
$config['db_user'] = 'root';
$config['db_pass'] = '';
$config['db_name'] = 'librenms';
$config['community'] = 'public';
$config['fping'] = '/usr/bin/fping';
$config['snmp']['community'] = array("public");
$config['auth_mechanism'] = "mysql";
$config['base_url'] = '/librenms';
$config['poller_modules']['ospf'] = 0;
$config['ping_bill'] = 1;
$config['php_memory_limit'] = '512M';
$config['rrdcached'] = "unix:/var/run/rrdcached.sock";
$config['alerts']['enable'] = 1;
$config['alerts']['rules'][] = array('name' => 'High port errors', 'rule' => '%ports.ifInErrors_rate > 20', 'severity' => 'critical');
After updating the configuration, run the following commands to update the dependencies of the project:
cd C:\xampp\htdocs\librenms
composer install --no-dev
A prompt will appear asking if you want to install the modules with elevated privileges. Click "Yes."
Once the installation process is complete, run the following command to validate and configure LibreNMS:
php build-base.php
It will take a few minutes to complete, and then you can log in to your LibreNMS web interface by visiting http://localhost/librenms on your web browser.
Conclusion
By following the above steps, you have successfully installed LibreNMS on your Windows 11 computer. You can now use LibreNMS to monitor your network devices and receive alerts when there are issues.