• ansible-librenms-containerized
  • Requirements
  • Role Variables
  • Dependencies
    • Recommended to use the following roles:
  • First run gotchas
    • Before Running this role
  • Example Playbook

ansible-librenms-containerized

A package that helps you set up Ansible, MariaDB, and LibreNMS all together.

NOTE: This is designed to run using Docker.

Requirements

• Docker
• Python
• Python-Pip
• Ansible version 2.2 or higher

Role Variables

Important settings you need to change:

librenms:
  app_key: "base64:Q0+ZV56/5Uwz79vsvS4ZfwQFOty3e9DJEouEy+IXvz8="
  base_url: "http://librenms.sd.dreamhost.com/"

Make sure to update "base64:Q0+ZV56/5Uwz79vsvS4ZfwQFOty3e9DJEouEy+IXvz8=" with your actual app key.

You can find other settings in the defaults/all.yml file.

Dependencies

Suggested roles to use:

• name: geerlingguy.docker
• name: geerlingguy.pip

First run gotchas

Before Running this role

You need to get an app key for the LibreNMS Docker image. This can be done with this command:

docker run --rm jarischaefer/docker-librenms generate_key

Example Playbook

- name: Setup LibreNMS Server
  hosts: librenms
  become: true
  tags: librenms

  tasks:
    - name: include docker role
      include_role:
        name: geerlingguy.docker

    - name: include pip role
      include_role:
        name: geerlingguy.pip
      vars:
        pip_install_packages:
          - name: docker

    - name: include librenms role
      include_role:
        name: nertwork.librenms_containerized