Community-based GPL-licensed network monitoring system
PHP JavaScript CSS HTML Python Shell Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Update lock.yml May 18, 2018
LibreNMS Tidy up some transport code from previous pr (#8927) Aug 17, 2018
app Use PDO for MySQL queries (#8935) Aug 17, 2018
bootstrap Use PDO for MySQL queries (#8935) Aug 17, 2018
cache fix: page/graph load speed: part 1 (#6611) May 10, 2017
config Use PDO for MySQL queries (#8935) Aug 17, 2018
contrib feature: New IP parsing classes. Removes usage of Pear Net_IPv4 and N… Aug 8, 2017
database Updates to snmptrap handling (#9010) Aug 14, 2018
doc Use PDO for MySQL queries (#8935) Aug 17, 2018
html Tidy up some transport code from previous pr (#8927) Aug 17, 2018
includes Fix dbFacile null parameters (#9031) Aug 18, 2018
lib webui: Removed unused JS causing issues with typeahead (#8307) Mar 9, 2018
licenses delete old stuff, put licenses into licenses Sep 29, 2011
logs fix: Errors in the documentations for CentOS 7 (#7510) Oct 18, 2017
mibs Added support for Huawei iBMC (#9011) Aug 15, 2018
misc Remove port association mode map from the database (#8941) Aug 5, 2018
resources Use PDO for MySQL queries (#8935) Aug 17, 2018
routes Add Laravel to LibreNMS (#8318) May 9, 2018
rrd fix: Errors in the documentations for CentOS 7 (#7510) Oct 18, 2017
scripts Added Juniper Junos syslog notification code (#9006) Aug 11, 2018
sql-schema Use PDO for MySQL queries (#8935) Aug 17, 2018
storage Add Laravel to LibreNMS (#8318) May 9, 2018
tests Use PDO for MySQL queries (#8935) Aug 17, 2018
.codeclimate.yml Codeclimate updates (#8918) Jul 17, 2018
.editorconfig added editorconfig file for project Jan 4, 2016
.env.example Add Laravel to LibreNMS (#8318) May 9, 2018
.gitignore New python service for poller, discovery + more (#8455) Jun 30, 2018
.mention-bot Update .mention-bot (#5371) Jan 9, 2017
.scrutinizer.yml refactor: use Composer to manage php dependencies (#5216) Jan 1, 2017
.travis.yml Add Laravel to LibreNMS (#8318) May 9, 2018
AUTHORS.md api: Added add_service_for_host endpoint to API (#8113) Jan 21, 2018
CHANGELOG.md Small Cleanup (#8871) Jul 7, 2018
CODE_OF_CONDUCT.md docs: Added code of conduct doc in root (#7055) Jul 21, 2017
CONTRIBUTING.md Point to the new place of the contributing documentation (#8276) Feb 21, 2018
LICENSE.txt Update copyright instructions Jun 23, 2014
Makefile webui: Removed unused JS causing issues with typeahead (#8307) Mar 9, 2018
README.md docs: Updated references for ##librenms to discord (#7523) Oct 20, 2017
addhost.php feature: Support for up/down detection of ping only devices. Oct 28, 2017
adduser.php refactor: Refactored authorizers to classes (#7497) Nov 18, 2017
alerts.php Alert transport fixes (#8967) Jul 31, 2018
artisan Add Laravel to LibreNMS (#8318) May 9, 2018
billing-calculate.php refactor: Various Code Cleanup (#5777) Feb 5, 2017
build-base.php Use PDO for MySQL queries (#8935) Aug 17, 2018
build.sql Db collation standardisation (#5932) Feb 27, 2017
check-services.php remove strict comparisons for check-services.php (#8992) Aug 7, 2018
composer.json Fixed snmptraps. (#8898) Aug 11, 2018
composer.lock Fixed snmptraps. (#8898) Aug 11, 2018
config.php.default docs: Use single quotes in example SNMP community per issue 8342 (#8348) Mar 9, 2018
config_to_json.php New python service for poller, discovery + more (#8455) Jun 30, 2018
cronic fix: Updated bin/bash to use env in cronic script (#4752) Oct 13, 2016
daily.php Allow ping checks to be ran separately from polling (#8821) Jul 30, 2018
daily.sh Allow ping checks to be ran separately from polling (#8821) Jul 30, 2018
delhost.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
discovery-wrapper.py Added ability to enable debug output with wrappers (#8830) Jun 20, 2018
discovery.php Improved Logging and Debugging (#8870) Jul 13, 2018
dist-pollers.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
irc.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
librenms-service.py Updated shebang on librenms-service.py (#8875) Jul 8, 2018
librenms.cron More more docs (#4197) Aug 25, 2016
librenms.nonroot.cron refactor: Switch to using discovery-wrapper.py by default (#7661) Nov 9, 2017
mkdocs.yml Updates to snmptrap handling (#9010) Aug 14, 2018
package.json Add Laravel to LibreNMS (#8318) May 9, 2018
pbin.sh updated pbin.sh to be inline with other scripts and use env bash (#6583) May 5, 2017
phpunit.xml Add Laravel to LibreNMS (#8318) May 9, 2018
ping.php Allow ping checks to be ran separately from polling (#8821) Jul 30, 2018
poll-billing.php Improved Logging and Debugging (#8870) Jul 13, 2018
poller-service.py feature: support non-standard unix socket (#5724) Apr 6, 2017
poller-wrapper.py Added ability to enable debug output with wrappers (#8830) Jun 20, 2018
poller.php Improved Logging and Debugging (#8870) Jul 13, 2018
readmegen.yml added changelog for v1.25 (#6018) Feb 26, 2017
renamehost.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
requirements.txt New python service for poller, discovery + more (#8455) Jun 30, 2018
server.php Add Laravel to LibreNMS (#8318) May 9, 2018
services-wrapper.py Added ability to enable debug output with wrappers (#8830) Jun 20, 2018
snmp-scan.py snmpscan.py: ignore bad DNS config (#8656) May 4, 2018
snmp.conf.example snmp.conf is not needed so do not recommend to set anything (#6204) Mar 16, 2017
snmpd.conf.example Documentation updates for DMI support and making two links in the FAQ… May 8, 2018
snmptrap.php Updates to snmptrap handling (#9010) Aug 14, 2018
syslog.php refactor: Centralize includes and initialization (#4991) Nov 21, 2016
validate.php Use PDO for MySQL queries (#8935) Aug 17, 2018
webpack.mix.js Add Laravel to LibreNMS (#8318) May 9, 2018

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.

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

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]