# How many instances of LibreNMS to run

We strongly recommend that you split your class out in to groups and only run 1 (one) LibreNMS instance per group for a total of 9 instead of 36 potential LibreNMS instances. If you use 36 your workshop kit will likely become unresponsive due to the very high overhead of the LibreNMS poller.

# Setting up a local git mirror

Note: this should probably go to noc.ws.nsrc.org, as they tend to be different hosts.

    apt-get install git
    mkdir -p /var/www/html/git
    cd /var/www/html/git
    git clone --bare https://github.com/librenms/librenms.git
    cd librenms.git
    git update-server-info

Users should now be able to:

    git clone http://www.ws.nsrc.org/git/librenms.git

NOTE: If you have problems using your local git repository, the fallback is to clone from the master LibreNMS git repo. To do replace the command above with:

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

Note: you need to clone the full repo if you want to be able to checkout the stable branch after.

Enabling the librenms[1-36].ws.nsrc.org addresses. Verify you have the proper $GENERATE statement in the bind db.ws.nsrc.org zone file. For instance, if using pc[1-36] addresses you would need:

G E N E R A T E1 − 36l i b r e n m s IN CNAME pc$