← Directory

port-light

Port occupancy map for a Docker host.

  • Tools & Utilities
Port occupancy map for a Docker host. Shows host listeners and container mappings in a traffic-light grid. Compose scanning is optional. Can pull occupancy JSON from other Port-Light instances. Includes a CLI and MCP server for port checks and reservations.

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

59/100 Fair

Maintained
93last commit 1 day ago
Popular
3664 GitHub stars
Easy to install
201 install platform, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
64
Open issues
0
Last commit
2026-10-12
Latest release
v0.8.5
License
MIT
Activity
declining

Checked today - source: GitHub (StepaniaH/port-light)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked today - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

Alternatives

No alternatives collected yet.

Common questions

Should I give Port-Light access to the Docker socket?

The Docker socket grants Docker API access, including write operations. Use a socket proxy if you need to restrict access.

How do I scan Compose files for declared ports?

Mount the directory containing your Compose stacks at /compose read-only and set COMPOSE_SCAN_DIR to /compose.

Where should I store Port-Light's local data?

Mount a local directory to /data; the Compose example uses ./data:/data.

Why might Port-Light not show a process name for a host listener?

Process names are taken from /host/proc when that mount is present.

Answers sourced from hub.docker.com, portlight.stepaniah.me

Community

No community discussions collected yet.