Community-based GPL-licensed network monitoring system
JavaScript HTML PHP CSS Python Shell Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github various small doc improvements (#5459) Jan 16, 2017
LibreNMS refactor: use Composer to manage php dependencies (#5216) Jan 1, 2017
contrib refactor: Centralize includes and initialization (#4991) Nov 21, 2016
doc fix link in performance doc (#5486) Jan 17, 2017
html newdevice: Add support for KTI switches (#5413) Jan 17, 2017
includes newdevice: APC Environmental monitoring units #5140 Jan 18, 2017
lib refactor: use Composer to manage php dependencies (#5216) Jan 1, 2017
licenses delete old stuff, put licenses into licenses Sep 29, 2011
mibs newdevice: added more support for dasan-nos (#5298) Jan 6, 2017
misc Updated alert_rules.json with more examples Nov 3, 2016
scripts trying to fix docs build (#5340) Jan 7, 2017
sql-schema newdevice: Add addition riverbed information #5170 Jan 17, 2017
tests newdevice: Add support for KTI switches (#5413) Jan 17, 2017
vendor fix: Update jpgraph source file to remove check for imageantialias() #… Jan 2, 2017
.codeclimate.yml Update .codeclimate.yml (#5044) Nov 22, 2016
.editorconfig added editorconfig file for project Jan 4, 2016
.gitignore added support for mention bot (#5347) Jan 8, 2017
.mention-bot Update .mention-bot (#5371) Jan 9, 2017
.scrutinizer.yml refactor: use Composer to manage php dependencies (#5216) Jan 1, 2017
.travis.yml Travis bash and python testing (#4917) Nov 3, 2016
AUTHORS.md I agree to the conditions of the Contributor Agreement contained in d… Jan 17, 2017
CHANGELOG Remove remaining live references to observium.org Oct 29, 2013
CONTRIBUTING.md Add contributing placeholder file May 16, 2015
LICENSE.txt Update copyright instructions Jun 23, 2014
Makefile Update typeahead to corejavascript fork Jan 6, 2016
README.md Happy New Year LibreNMS users! (#5240) Dec 31, 2016
addhost.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
adduser.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
alerts.php fix: update any IP fields using inet6_ntop() #5207 Dec 29, 2016
billing-calculate.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
build-base.php fix: This change broke the web installer Sep 16, 2016
build.sql feature: Add mysql failed query logging + fixed queries that break ON… Jan 7, 2017
check-services.php feature: Add services-wrapper.py to enable support for distributed se… Jan 12, 2017
composer.json refactor: use Composer to manage php dependencies (#5216) Jan 1, 2017
config.php.default refactor: Default to only using mysqli (#4915) Nov 11, 2016
config_to_json.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
cronic fix: Updated bin/bash to use env in cronic script (#4752) Oct 13, 2016
daily.php fix: msyql errors bgp-peers, daily, callback (#5425) Jan 13, 2017
daily.sh fix: daily.sh install path (#5152) Dec 12, 2016
delhost.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
discovery-wrapper.py feature: Added new discovery-wrapper.py script to replicate poller-wr… Sep 9, 2016
discovery.php refactor: MySQL strict and query fixes (#5338) Jan 13, 2017
dist-pollers.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
irc.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
librenms.cron More more docs (#4197) Aug 25, 2016
librenms.nonroot.cron More more docs (#4197) Aug 25, 2016
mkdocs.yml trying to fix docs build (#5340) Jan 7, 2017
phpunit.xml RRDtool dual process (remote creation/check) (#4104) Aug 22, 2016
poll-billing.php refactor: MySQL strict and query fixes (#5338) Jan 13, 2017
poller-service.py Use python2 in Python script shebang lines Apr 11, 2016
poller-wrapper.py refactor: Updated a lot of references to LibreNMS - copyright still l… Sep 8, 2016
poller.php fix: restore usage of -i -n in polling (#5228) Dec 22, 2016
readmegen.yml Updated changelog for v1.23 (#5280) Jan 1, 2017
renamehost.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
services-wrapper.py feature: Add services-wrapper.py to enable support for distributed se… Jan 12, 2017
snmp-scan.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
snmp.conf.example Remove user-facing references to Observium Nov 4, 2013
snmpd.conf.example Fix example community string Oct 24, 2014
snmptrap.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
syslog.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
validate.php fix: validate suid is set for fping (#5474) Jan 16, 2017

README.md

Scrutinizer Status Scrutinizer Code Quality Travis Status

Introduction

LibreNMS is an autodiscovering 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. LibreNMS is a community-based fork of Observium.

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 will be the basis of our priority system, and mutual respect is the basis of our behaviour towards others. For more about the culture we're trying to build, please read the Freenode philosophy, including guidelines for running an IRC channel and being a community catalyst.

Documentation

Documentation can be found in the doc directory or docs.librenms.org, including instructions for installing and contributing.

Participating

You can participate in the project by:

VM image

You can try LibreNMS by downloading a VM image. Currently, a Ubuntu-based image is supplied and has been tested with VirtualBox.

Download one of the VirtualBox images we have available, documentation is provided which details login credentials and setup details.

License

Copyright (C) 2006-2012 Adam Armstrong adama@memetic.org

Copyright (C) 2013-2017 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 http://www.gnu.org/licenses/.

LICENSE.txt 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