librenms / librenms

Introduction
------------
LibreNMS is an auto-discovering PHP/MySQL/SNMP based network monitoring
which includes support for a wide range of network hardware and operating
systems including Cisco, Linux, FreeBSD, Juniper, Brocade, Foundry, HP and
many more.
We intend LibreNMS to be a viable project and community that:
- encourages contribution,
- focuses on the needs of its users, and
- offers a welcoming, friendly environment for everyone.
The [Debian Social Contract][10] will be the basis of our priority system,
and mutual respect is the basis of our behavior towards others.
Documentation
-------------
Documentation can be found in the [doc directory][5] or [docs.librenms.org][16], including instructions
for installing and contributing.
Participating
-------------
You can participate in the project by:
- Talking to us on [Discord][4] or [Twitter][3].
- Joining the LibreNMS Community
- Improving the [documentation][5].
- Cloning the [repository][2] and filing [pull requests][19] on GitHub.
- Bug Reports on our Community Forums
- See [CONTRIBUTING][15] for more details.
VM image
--------
You can try LibreNMS by downloading a VM image. Currently, a Ubuntu-based
image is supplied and has been tested with [VirtualBox][8].
Download one of the [VirtualBox images][11] we have available, documentation is provided which details
login credentials and setup details.
License
-------
Copyright (C) 2006-2012 Adam Armstrong 
Copyright (C) 2013-2026 by individual LibreNMS contributors
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program. If not, see .
[LICENSE.txt][14] contains a copy of the full GPLv3 licensing conditions.
The following additional license conditions apply to LibreNMS (a GPL
exception):
 As a special exception, you have permission to link or otherwise combine
 LibreNMS with the included copies of the following third-party software,
 and distribute modified versions, as long as you follow the requirements
 of the GNU GPL v3 in regard to all of the remaining software (comprising
 LibreNMS).
 Please see [Acknowledgements][17]
[2]: https://github.com/librenms/librenms "Main LibreNMS GitHub repo"
[3]: https://twitter.com/librenms "@LibreNMS on Twitter"
[4]: https://discord.gg/librenms "Discord LibreNMS Server"
[5]: https://github.com/librenms/librenms/tree/master/doc/
[8]: https://www.virtualbox.org/ "VirtualBox"
[10]: http://www.debian.org/social_contract "Debian project social contract"
[11]: https://www.librenms.org/#downloads
[14]: htt