# port-light

port-light is a self-hosted tools & utilities app. Port occupancy map for a Docker host. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6956/port-light

## Description

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.

## Health score

59/100 (Fair), based on 3 of 4 factors.
- Maintained: 93 (last commit 1 day ago)
- Popular: 36 (64 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/port-light-1avxhcx0ugtgml?q=port-light
- GitHub: https://github.com/StepaniaH/port-light
- Official website: https://portlight.stepaniah.me/
- Documentation: https://hub.docker.com/r/stepaniah/port-light

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/6956/port-light), the self-hosted and open-source app directory.