// 001 · product

harbormasterd

Zero-thinking port management for local development. Automatic ports, *.pa.local DNS, zero-config HTTPS — never see "port already in use" again.

pypi v1.1.0 python 3.10+ license MIT ci passing release v1.1.0

$ pip install harbormasterd

view source → · changelog

— zsh · 80×24

$ pa run --name=api --prefer=3000 -- npm run dev
# port 3000 in use? no problem.
✓ assigned port 60001
✓ dns configured: api.pa.local
✓ tls ready: https://api.pa.local
→ server running at https://api.pa.local

// 002 · the harbor

Three concerns, solved once.

Port conflicts, ugly URLs, and HTTPS warnings — cleared before you open a browser. Each is a small problem that compounds across a development career.

→ 01

Auto port assignment

Port 3000 in use? Harbormasterd finds an open one, instantly. No more killing processes, rewriting configs, or appending :8081 to every URL. Process exits — lease released. Next start reclaims the same port until you don't.

→ 02

*.pa.local URLs

Services live at myapp.pa.local — local resolver, zero /etc/hosts edits per project.

→ 03

Automatic HTTPS

mkcert certificates issued on demand. Trust once, forget browser warnings forever.

// 003 · first voyage

Under way in 30 seconds.

Install from PyPI, start the daemon, run the one-time trust + DNS setup. Then forget harbormasterd exists.

Three CLIs ship in the box: pa for daily dev, pa-platform for one-time setup, pad for the daemon. Most users only need the first.

Cross-platform: Linux, macOS, WSL. Python 3.10+. MIT licensed.

# quickstart · linux · macos · wsl

# 1. install
$ pip install harbormasterd

# 2. start the daemon
$ pad &

# 3. one-time setup — trust certs + dns
$ pa-platform tls trust
$ pa-platform dns install

# 4. run anything — port, dns, https handled
$ pa run --name=myapp --prefer=3000 -- npm run dev
→ https://myapp.pa.local