## [![DebOps project](http://debops.org/images/debops-small.png)](http://debops.org) librenms

<!-- This file was generated by Ansigenome. Do not edit this file directly but
     instead have a look at the files in the ./meta/ directory. -->

[![Travis CI](http://img.shields.io/travis/debops/ansible-librenms.svg?style=flat)](http://travis-ci.org/debops/ansible-librenms) [![test-suite](http://img.shields.io/badge/test--suite-ansible--librenms-blue.svg?style=flat)](https://github.com/debops/test-suite/tree/master/ansible-librenms/)  [![Ansible Galaxy](http://img.shields.io/badge/galaxy-debops.librenms-660198.svg?style=flat)](https://galaxy.ansible.com/detail#/role/4721)

[LibreNMS](http://www.librenms.org/) is a network monitoring dashboard written
in PHP. It can use SNMP, `collectd`, `check_mk` or other agents to gather
data from a variety of devices (switches, routers, servers, etc.) and graph
them using RRD. It's easy to use, and can perform autodiscovery to find and
monitor additional devices.

`debops.librenms` role will manage a central LibreNMS monitoring host and
web interface.

### Installation

This role requires at least Ansible `v1.8.0`. To install it, run:

```Shell
ansible-galaxy install debops.librenms
```

### Documentation

More information about `debops.librenms` can be found in the
[official debops.librenms documentation](http://docs.debops.org/en/latest/ansible/roles/ansible-librenms/docs/).


### Role dependencies

- `debops.secret`
- `debops.php5`
- `debops.nginx`
- `debops.mariadb`

### Are you using this as a standalone role without DebOps?

You may need to include missing roles from the [DebOps common
playbook](https://github.com/debops/debops-playbooks/blob/master/playbooks/common.yml)
into your playbook.

[Try DebOps now](https://github.com/debops/debops) for a complete solution to run your Debian-based infrastructure.





### Authors and license

`librenms` role was written by:

- Maciej Delmanowski | [e-mail](mailto:drybjed@gmail.com) | [Twitter](https://twitter.com/drybjed) | [GitHub](https://github.com/drybjed)

License: [GPLv3](https://tldrlegal.com/license/gnu-general-public-license-v3-%28gpl-3%29)

***

This role is part of the [DebOps](http://debops.org/) project. README generated by [ansigenome](https://github.com/nickjj/ansigenome/).
