crocofied/PortNote

Health v2 · maintenance only

Adoption not part of the score

1262 stars · 33 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

PortNote is a self-hosted web application for documenting and tracking which services use which ports across servers and VMs. It provides a dashboard for assigning port usage, detecting conflicts, and generating random available ports.

Use cases

• track which services use which ports across my servers
• avoid port conflicts in my homelab
• document port assignments instead of using spreadsheets
• generate a random unused port
• manage port usage across multiple VMs
• self-hosted port documentation tool

When to choose

• you run multiple servers or VMs and lose track of port assignments
• you want a self-hosted web UI for port documentation
• you want conflict detection and a random port generator
• you prefer Docker Compose deployment with PostgreSQL

When to avoid

• you need automatic port discovery/scanning rather than manual documentation
• you want enterprise-scale IPAM or full network inventory management
• you need integration with firewalls or load balancers

Facets

application · maturity active

web-framework database auth developer-tools developer-tools self-hosted networking infrastructure-as-code self-hosted port-management port-tracking network-documentation homelab docker-compose nextjs prisma docker web-server nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="crocofied/PortNote")