# crocofied/PortNote

Keep track of used ports

Repository: https://github.com/crocofied/PortNote
Canonical: https://ross.abutalabs.com/products/portnote
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2025-05-14T14:05:47+00:00

## Health v2 (maintenance only)
Score: 30/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 21, release rhythm 40, longevity 34
- inputs: {"age_days": 480, "days_push": 476, "days_rel": 476, "gap_med": 1.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1262, forks 33 (observed 2026-08-28T04:04:10.315997+00:00)

## What it is
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
- artifact type: application
- maturity: active
- function: web-framework, database, auth, developer-tools
- domain: developer-tools, self-hosted, networking, infrastructure-as-code
- platform: self-hosted
- tags: port-management, port-tracking, network-documentation, homelab, docker-compose, nextjs, prisma, docker, web-server, nodejs

## Member repositories
- crocofied/PortNote (main) score 30

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:10.315997+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:04:13.632075+00:00, confidence not recorded.
  - readme: https://github.com/crocofied/PortNote (fetched 2026-08-28T04:04:10.315997+00:00, sha 82d5d11b2194)
- Data as of 2026-08-30T08:39:29.467469+00:00.