Community-based GPL-licensed network monitoring system
Go to file
TheGreatDoc eadf27cbcc Change group owner for php/session for CentOS 7 nginx install (#9393)
By default on CentOS 7, /var/lib/php/session is root:root.

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
After you are done testing, you can remove the changes with `./scripts/github-remove`.  If there are schema changes, you can ask on discord how to revert.
2018-11-28 21:28:04 +00:00
.github verbage 2018-09-17 12:08:13 -05:00
app Fix global read check for demo account (#9482) 2018-11-27 10:28:26 -06:00
bootstrap Revert "Attempt to make proxy sub-dir -> app no subdir work" (#9341) 2018-10-18 09:15:48 -05:00
cache fix: page/graph load speed: part 1 (#6611) 2017-05-10 08:57:10 +01:00
config Revert "Attempt to make proxy sub-dir -> app no subdir work" (#9341) 2018-10-18 09:15:48 -05:00
contrib feature: New IP parsing classes. Removes usage of Pear Net_IPv4 and Net_IPv6. (#7106) 2017-08-08 14:14:58 -05:00
database Update syslog display and backend (#9228) 2018-09-20 21:33:03 +01:00
doc Change group owner for php/session for CentOS 7 nginx install (#9393) 2018-11-28 21:28:04 +00:00
html order by sensor_descr aswell (#9478) 2018-11-27 21:30:08 -06:00
includes Fixed Procera ports ifIndex and ports added by the poller (#9384) 2018-11-28 21:08:42 +00:00
LibreNMS Added more sensors for IRD (PBI Digital Decoder) (#9339) 2018-11-20 16:54:42 -06:00
licenses delete old stuff, put licenses into licenses 2011-09-29 15:58:18 +00:00
logs Fix file mode broke in #9218 (#9299) 2018-10-05 15:45:56 +01:00
mibs Updated detection for AKCP devices (#9460) 2018-11-19 18:23:18 -06:00
misc add app for getting status of TCP connections for specified services (#8090) 2018-11-22 09:05:38 -06:00
resources Disable page refresh on health sensors pages, autorefresh most tables (#9386) 2018-11-08 22:29:20 +00:00
routes Graph of overall poller performance (#9381) 2018-10-26 21:04:30 +01:00
rrd Fix file mode broke in #9218 (#9299) 2018-10-05 15:45:56 +01:00
scripts fixing option to let user pick saved test data filename, exit if ther… (#9242) 2018-11-21 13:27:53 -06:00
sql-schema Added ability to record traceroutes for devices down due to ICMP (#9457) 2018-11-19 09:58:59 -06:00
storage Add Laravel to LibreNMS (#8318) 2018-05-09 08:05:17 -05:00
tests Fixed Procera ports ifIndex and ports added by the poller (#9384) 2018-11-28 21:08:42 +00:00
.codeclimate.yml More codeclimate tuning (#9197) 2018-09-13 12:18:58 -05:00
.editorconfig added editorconfig file for project 2016-01-04 13:16:13 +01:00
.env.example Add Laravel to LibreNMS (#8318) 2018-05-09 08:05:17 -05:00
.gitignore New python service for poller, discovery + more (#8455) 2018-06-30 12:19:49 +01:00
.mention-bot Update .mention-bot (#5371) 2017-01-09 21:19:03 +00:00
.scrutinizer.yml refactor: use Composer to manage php dependencies (#5216) 2017-01-01 09:37:15 +00:00
.travis.yml Updated to use new theme for docs site (#9320) 2018-10-27 23:04:34 +01:00
addhost.php feature: Support for up/down detection of ping only devices. 2017-10-27 22:59:25 -05:00
adduser.php Use Laravel authentication (#8702) 2018-09-11 07:51:35 -05:00
alerts.php Alert transport fixes (#8967) 2018-07-31 21:53:03 +01:00
artisan Add Laravel to LibreNMS (#8318) 2018-05-09 08:05:17 -05:00
AUTHORS.md Updated MGE UPS sensors and added traps (#9301) 2018-10-17 17:03:51 +01:00
billing-calculate.php refactor: Various Code Cleanup (#5777) 2017-02-05 22:37:08 +00:00
build-base.php Use PDO for MySQL queries (#8935) 2018-08-17 21:29:20 +01:00
build.sql Db collation standardisation (#5932) 2017-02-27 18:28:01 +00:00
CHANGELOG.md Small Cleanup (#8871) 2018-07-07 13:55:17 +01:00
check-services.php remove strict comparisons for check-services.php (#8992) 2018-08-06 20:29:06 -05:00
CODE_OF_CONDUCT.md docs: Added code of conduct doc in root (#7055) 2017-07-21 12:36:33 -05:00
composer.json Revert "Attempt to make proxy sub-dir -> app no subdir work" (#9341) 2018-10-18 09:15:48 -05:00
composer.lock Move ext-mysqlnd to suggested for now (even though it is actually required) (#9229) 2018-09-20 00:05:10 +01:00
config_to_json.php New python service for poller, discovery + more (#8455) 2018-06-30 12:19:49 +01:00
config.php.default docs: Use single quotes in example SNMP community per issue 8342 (#8348) 2018-03-09 17:26:29 +01:00
CONTRIBUTING.md Point to the new place of the contributing documentation (#8276) 2018-02-21 21:50:24 +00:00
cronic fix: Updated bin/bash to use env in cronic script (#4752) 2016-10-13 22:23:53 +01:00
daily.php Fix reference (#9328) 2018-10-16 08:00:50 +01:00
daily.sh Allow ping checks to be ran separately from polling (#8821) 2018-07-30 22:58:38 +01:00
delhost.php refactor: Centralize includes and initialization (#4991) 2016-11-21 20:12:59 +00:00
discovery-wrapper.py Added ability to enable debug output with wrappers (#8830) 2018-06-20 22:56:51 +01:00
discovery.php Improved Logging and Debugging (#8870) 2018-07-13 23:08:00 +01:00
dist-pollers.php refactor: Centralize includes and initialization (#4991) 2016-11-21 20:12:59 +00:00
irc.php refactor: Centralize includes and initialization (#4991) 2016-11-21 20:12:59 +00:00
librenms-service.py Updated shebang on librenms-service.py (#8875) 2018-07-08 22:25:29 +01:00
librenms.cron More more docs (#4197) 2016-08-25 18:40:11 -05:00
librenms.nonroot.cron Add note to cron file advising not to disable daily.sh (#9164) 2018-09-06 22:30:31 +01:00
LICENSE.txt Update copyright instructions 2014-06-23 13:44:12 +10:00
Makefile webui: Removed unused JS causing issues with typeahead (#8307) 2018-03-09 18:11:24 +01:00
mkdocs.yml Update docs for virtual images (#9456) 2018-11-17 14:19:38 +00:00
package.json Add Laravel to LibreNMS (#8318) 2018-05-09 08:05:17 -05:00
pbin.sh updated pbin.sh to be inline with other scripts and use env bash (#6583) 2017-05-05 07:52:52 +01:00
phpunit.xml Add Laravel to LibreNMS (#8318) 2018-05-09 08:05:17 -05:00
ping.php Fix ping.php poller groups setting 2018-11-12 09:27:28 -06:00
poll-billing.php Added cli options debug and bill_id to poll-billing.php (#9042) 2018-08-25 21:57:08 +01:00
poller-service.py feature: support non-standard unix socket (#5724) 2017-04-06 22:02:37 +01:00
poller-wrapper.py Added ability to enable debug output with wrappers (#8830) 2018-06-20 22:56:51 +01:00
poller.php Improved Logging and Debugging (#8870) 2018-07-13 23:08:00 +01:00
README.md docs: Updated references for ##librenms to discord (#7523) 2017-10-20 14:22:18 -05:00
readmegen.yml added changelog for v1.25 (#6018) 2017-02-26 22:14:06 +00:00
renamehost.php refactor: Centralize includes and initialization (#4991) 2016-11-21 20:12:59 +00:00
requirements.txt New python service for poller, discovery + more (#8455) 2018-06-30 12:19:49 +01:00
server.php Add Laravel to LibreNMS (#8318) 2018-05-09 08:05:17 -05:00
services-wrapper.py Added ability to enable debug output with wrappers (#8830) 2018-06-20 22:56:51 +01:00
snmp-scan.py snmpscan.py: ignore bad DNS config (#8656) 2018-05-04 09:46:18 -05:00
snmp.conf.example snmp.conf is not needed so do not recommend to set anything (#6204) 2017-03-16 13:52:23 -05:00
snmpd.conf.example Documentation updates for DMI support and making two links in the FAQ work (#8440) 2018-05-08 18:35:25 -05:00
snmptrap.php Updates to snmptrap handling (#9010) 2018-08-14 07:56:16 +01:00
syslog.php refactor: Centralize includes and initialization (#4991) 2016-11-21 20:12:59 +00:00
validate.php Don't check file permissions on every request, handle failures (#9264) 2018-10-18 21:08:46 -05:00
webpack.mix.js Add Laravel to LibreNMS (#8318) 2018-05-09 08:05:17 -05:00

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]