NOTE: These instructions assume you are the root user. If you
are not, prepend sudo to the shell commands (the ones that aren't
at mysql> prompts) or temporarily become a user with root
privileges with sudo -s or sudo -i.

Web Server

Configure PHP

Ensure date.timezone is set in php.ini to your preferred time zone.
See http://php.net/manual/en/timezones.php for a list of supported
timezones. Valid examples are: "America/New_York",
"Australia/Brisbane", "Etc/UTC".

Cron job

cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms

NOTE: Keep in mind that cron, by default, only uses a very limited
set of environment variables. You may need to configure proxy
variables for the cron invocation. Alternatively adding the proxy
settings in config.php is possible too. The config.php file will be
created in the upcoming steps. Review the following URL after you
finished librenms install steps:
https://docs.librenms.org/Support/Configuration/#proxy-support

Copy logrotate config

LibreNMS keeps logs in /opt/librenms/logs. Over time these can
become large and be rotated out. To rotate out the old logs you can
use the provided logrotate config file:

cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms

Web installer

Now head to the web installer and follow the on-screen instructions.

http://librenms.example.com/install.php

The web installer might prompt you to create a config.php file in
your librenms install location manually, copying the content displayed
on-screen to the file. If you have to do this, please remember to set
the permissions on config.php after you copied the on-screen contents
to the file. Run:

chown librenms:librenms /opt/librenms/config.php

Final steps

That's it! You now should be able to log in to
http://librenms.example.com/. Please note that we have not covered
HTTPS setup in this example, so your LibreNMS install is not secure by
default. Please do not expose it to the public Internet unless you
have configured HTTPS and taken appropriate web server hardening
steps.

Add the first device

We now suggest that you add localhost as your first device from within the WebUI.

Troubleshooting

If you ever have issues with your install, run validate.php as root in
the librenms directory: