https://github.com/netdisco/netdisco

A web-based network management tool.
https://github.com/netdisco/netdisco

application cpan netdisco network-monitoring network-visualization open-source perl postgresql-database

Last synced: 21 days ago
JSON representation

A web-based network management tool.

• Host: GitHub
• URL: https://github.com/netdisco/netdisco
• Owner: netdisco
• License: bsd-3-clause
• Created: 2017-01-04T16:07:45.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2025-04-08T08:55:40.000Z (26 days ago)
• Last Synced: 2025-04-14T04:09:03.096Z (21 days ago)
• Topics: application, cpan, netdisco, network-monitoring, network-visualization, open-source, perl, postgresql-database
• Language: Perl
• Homepage: http://netdisco.org/
• Size: 10.3 MB
• Stars: 709
• Watchers: 41
• Forks: 81
• Open Issues: 55
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE.md
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-starred - netdisco/netdisco - A web-based network management tool. (perl)

README

        
[![CPAN version](https://badge.fury.io/pl/App-Netdisco.svg)](https://metacpan.org/pod/App::Netdisco)

[![Release date](https://img.shields.io/github/release-date/netdisco/netdisco.svg?label=released)](https://metacpan.org/pod/App::Netdisco)

[![Tests Status](https://github.com/netdisco/netdisco/actions/workflows/test_and_publish.yml/badge.svg?event=push)](https://github.com/netdisco/netdisco/actions/workflows/test_and_publish.yml)

[![Docker Image](https://img.shields.io/badge/docker%20images-ready-blue.svg)](https://store.docker.com/community/images/netdisco/netdisco)

**Netdisco** is a web-based network management tool suitable for small to very large networks. IP and MAC address data is collected into a PostgreSQL database using SNMP, CLI, or device APIs. Some of the things you can do with Netdisco:

* Locate a machine on the network by MAC or IP and show the switch port it lives at

* Turn off a switch port, or change the VLAN or PoE status of a port

* Inventory your network hardware by model, vendor, software and operating system

* Pretty pictures of your network

See the demo at: [https://netdisco2-demo.herokuapp.com/](https://netdisco2-demo.herokuapp.com/)

##  Installation

Netdisco is written in Perl and Python and is self-contained apart from the PostgreSQL database, so is very easy to install and runs well on any linux or unix system. We also have [docker images](https://store.docker.com/community/images/netdisco/netdisco) if you prefer.

It includes a lightweight web server for the interface, a backend daemon to gather data from your network, and a command line interface for troubleshooting. There is a simple configuration file in YAML format.

Please check out the [installation instructions](https://metacpan.org/pod/App::Netdisco) on CPAN. When upgrading, make sure to check the latest [Release Notes](https://github.com/netdisco/netdisco/wiki/Release-Notes).

You can also speak to someone in the [`#netdisco@libera`](https://kiwiirc.com/nextclient/irc.libera.chat/netdisco) IRC channel, or on the [community email list](https://lists.sourceforge.net/lists/listinfo/netdisco-users).