v0.1.2 is live

Every local server.One clear view.

PortDoc shows what is running, which project owns each port, and what you can safely stop. No more digging through old terminal tabs or guessing what took port 3000.

Install PortDocView on GitHub

Open source · Local only · macOS, Linux, and Windows

127.0.0.1:7788
PortDoc dashboard showing active services grouped by project, ports, process details, and status labels

Built for local development

The answers you need, before the next command.

PortDoc turns raw socket and process data into a calm dashboard that makes sense to working developers.

:30

Find the port owner

Look up any port and see the process, PID, project, command, age, and exposure in one place.

LOOK UP A PORTInspect →
3000
~/

See services by project

Vite, Next.js, Express, Docker, databases, and background services are grouped under the repo that owns them.

startdev4 running
vidpipe3 running
✓

Stop safely

Stop stale services with confirmation and process checks. PortDoc protects itself and verifies that the port was released.

next-dashboardmain
:3000

Next.js localhost:3000

node · PID 18422 · next dev

Open ↗□ Stop● running 2h
 

Know what is exposed

Local, LAN-visible, Docker, and unknown services are clearly labeled so you never mistake a public bind for localhost.

 

Open the right thing fast

Open a service URL, reveal its folder, copy the project path, or jump into your configured editor from the same dashboard.

New in v0.1.2

Run PortDoc your way.

Run portdoc in an interactive terminal and choose whether it stays attached to that terminal or runs in the background under your operating system's native process manager.

Scripts and other noninteractive launches stay prompt-free and continue in foreground mode.

Foregroundattached

Keep it in the terminal

PortDoc stays attached to the current terminal. Close it with Ctrl+Cwhen you are done.

$ portdoc foreground

portdoc ui remains available as a foreground alias.

Backgroundmanaged

Let your operating system manage it

PortDoc starts immediately, keeps running after the terminal closes, and starts again when you sign in. Administrator access is not required.

portdoc background start

Install or refresh the manager entry, start now, and enable sign-in startup.

portdoc background status

Check the native manager entry and PortDoc health endpoint.

portdoc background stop

Stop PortDoc now while keeping sign-in startup enabled.

portdoc background disable

Stop PortDoc and remove its sign-in startup entry.

Native on every platform

Linux

systemd user service

macOS

LaunchAgent

Windows

Task Scheduler

Install in seconds

One binary. No account. No setup maze.

Install PortDoc, run one command, choose how it should run, and open a live view of the services on your machine.

  1. 1

    Install the binary

    Choose the command for your platform.

  2. 2

    Run portdoc

    Choose foreground or background when prompted.

  3. 3

    Open the dashboard

    Both modes open the same private local dashboard.

install portdoc
macOS and Linuxshell
$ curl -fsSL https://portdoc.dev/install.sh | sh
WindowsPowerShell
PS> irm https://portdoc.dev/install.ps1 | iex
HomebrewmacOS and Linux
$ brew install bradtraversy/tap/portdoc
✓ Then run portdoc and choose foreground or background.
●

Private by default

Your process data stays on your machine.

PortDoc binds to localhost, sends nothing to the cloud, and needs no login. It is a local tool for local development, exactly as it should be.

✓No telemetry
✓No account
✓Open source

Clear the port confusion

See what is running. Keep building.

PortDoc is free, open source, and ready for macOS, Linux, and Windows.

Install PortDocStar on GitHub ↗