PortNote
Self-hosted port inventory to document which services use which ports across servers and VMs, helping prevent conflicts and keep infrastructure organized.
PortNote is a self-hosted web application for tracking and documenting which network ports are in use across your servers and virtual machines. It centralizes port assignments and related notes so you can avoid conflicts and keep a clear overview of your infrastructure.
Key Features
- Web UI to add servers/VMs and record port usage per system
- Central dashboard view of your port landscape
- Create and document port assignments to prevent collisions
- Random port generator to help pick unused ports
- Authentication via configurable login credentials
Use Cases
- Maintain an internal registry of ports used by homelab or production services
- Plan migrations and deployments without accidentally reusing ports
- Audit and document service exposure and port allocations across hosts
Limitations and Considerations
- Requires a PostgreSQL database backend
- Designed for manual documentation rather than automatic network scanning
PortNote helps replace spreadsheets with a structured, searchable inventory of port assignments. It is a practical tool for teams and individuals who want clearer operational visibility and fewer port-related surprises.