= Configuring LibreNMS on Single server Multi virtual host environment =

This will guide you through installing LibreNMS setup on Ubuntu 20.04 LTS server with NGINX running as the web server. 

=== Requirements ===

* Linux Server running Ubuntu 20.04 LTS
* NGINX Installed.
* SSL/ HTTPS Certificates issued ( May be using Letsencrypt or Otherwise)
* sudo access to the server. All following commands have to be entered as the root user. Best way to do it is, by login in as root with {{{ sudo su }}}

=== Installation Packages ===

`apt install software-properties-common`

`add-apt-repository universe`

`apt update`

`apt install acl curl composer fping git graphviz imagemagick mariadb-client mariadb-server mtr-tiny nginx-full nmap php7.4-cli php7.4-curl php7.4-fpm php7.4-gd php7.4-json php7.4-mbstring php7.4-mysql php7.4-snmp php7.4-xml php7.4-zip rrdtool snmp snmpd whois unzip python3-pymysql python3-dotenv python3-redis python3-setuptools python3-systemd`

=== Adding User for LibreNMS ===

Adding user into LibreNMS

`useradd librenms -d /opt/librenms -M -r -s "$(which bash)"`


=== Download LibreNMS ===

`cd /opt`

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


Setting Permission for LibreNMS

`chown -R librenms:librenms /opt/librenms`

`chmod 771 /opt/librenms`

`setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/`

`setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/`


=== Installing PHP dipendencies ===

` su - librenms`

`./scripts/composer_wrapper.php install --no-dev`

`exit`