Fresh install - WebUI Install page is broke

Help
1

I am installing libreNMS on a new server. I followed the installation procedure until I reached the /install page on my server. However, this page is not loading correctly and I am unable to do much on it.

Capture d'écran 2025-11-10 180400
Capture d'écran 2025-11-10 180400302×599 10.5 KB

When I look at the nginx logs, I see lots of access errors on the installation pages.

2025/11/10 18:05:25 [crit] 144305#144305: *39 stat() "/opt/librenms/html/install/checks" failed (13: Permission denied), client: 10.150.34.2, server: sup0094vu.jmsp.prod, request: "GET /install/checks HTTP/1.1", host: "sup0094vu.jmsp.prod", referrer: "http://sup0094vu.jmsp.prod/install/checks"
2025/11/10 18:05:25 [crit] 144305#144305: *39 stat() "/opt/librenms/html/install/checks" failed (13: Permission denied), client: 10.150.34.2, server: sup0094vu.jmsp.prod, request: "GET /install/checks HTTP/1.1", host: "sup0094vu.jmsp.prod", referrer: "http://sup0094vu.jmsp.prod/install/checks"
2025/11/10 18:05:25 [crit] 144305#144305: *39 stat() "/opt/librenms/html/install/checks" failed (13: Permission denied), client: 10.150.34.2, server: sup0094vu.jmsp.prod, request: "GET /install/checks HTTP/1.1", host: "sup0094vu.jmsp.prod", referrer: "http://sup0094vu.jmsp.prod/install/checks"

librenms@sup0094vu:~$ ./validate.php 
===========================================
Component | Version
--------- | -------
LibreNMS  | 25.11.0-dev.95+3c8a2cf25 (2025-11-10T09:24:31+01:00)
DB Schema | Not Connected (0)
PHP       | 8.3.6
Python    | 3.12.3
Database  | Not Connected
RRDTool   | 1.7.2
SNMP      | 5.9.4.pre2
===========================================

[OK]    Composer Version: 2.8.12
[OK]    Dependencies up-to-date.
[FAIL]  Database credentials incorrect. Double check credentials in DB_USERNAME and DB_PASSWORD either in environment or in /opt/librenms/.env
        Error::
         SQLSTATE[HY000] [1045] Access denied for user 'librenms'@'localhost' (using password: NO)
[FAIL]  Caching server issue: SQLSTATE[HY000] [1045] Access denied for user 'librenms'@'localhost' (using password: NO) (Connection: mysql, SQL: update `cache_locks` set `owner` = rU3411peQG2NUmzV, `expiration` = 1762794559 where `key` = laravel_cache_dist_test_validation and (`owner` = rU3411peQG2NUmzV or `expiration` <= 1762794554))
[OK]    Redis is unavailable
PHP Error(8192): is_executable(): Passing null to parameter #1 ($filename) of type string is deprecated in /opt/librenms/LibreNMS/Validations/Programs.php:124
PHP Error(8192): preg_match(): Passing null to parameter #2 ($subject) of type string is deprecated in /opt/librenms/LibreNMS/Validations/Programs.php:109
[INFO]  fping FAILURES can be ignored if running LibreNMS in a jail without ::1. You may want to test it manually: fping ::1
[FAIL]  /usr/bin/fping6 could not be executed. /usr/bin/fping6 must have CAP_NET_RAW capability (getcap) or suid. Selinux exclusions may be required.
 (/usr/bin/fping6: can't create socket (must run as root?))
[FAIL]  /usr/bin/fping6 should have CAP_NET_RAW!
        [FIX]: 
        setcap cap_net_raw+ep /usr/bin/fping6
[OK]    rrd_dir is writable
[OK]    rrdtool version ok
[FAIL]  Caching server issue: SQLSTATE[HY000] [1045] Access denied for user 'librenms'@'localhost' (using password: NO) (Connection: mysql, SQL: select * from `cache` where `key` in (laravel_cache_scheduler_working))

Can you please help me with that ?

2

That seems like you’ve not followed the complete install instructions. I’d recommend going back over them and re-doing it.

3

I also experienced this issue, when following the install guide step by step. In the end I resolved it by adding the nginx user to the librenms group

4

Hi, you should enable www-data access /opt/librenms/html/ maybe like this : sudo setfacl -R -m g:www-data:rx /opt/librenms/html

5

Thanks for the answer, it’s working now

6

That’s not needed if the install docs haven been followed.