🚀 PortPilot

Map your local apps to custom domains in seconds.
No admin headaches. No proxy mess. Just code, run, and go!

Now with 1-click HTTPS (auto SSL via mkcert)

Features

Modern local dev, zero chaos

🔗
Custom Domain Mapping
Map your local ports to domains like myapp.local instantly.
🧠
No Hosts File Editing
No need to touch /etc/hosts — PortPilot handles it for you.
🖥️
Cross-Platform
Works on macOS, Windows, and Linux — with auto-setup.
🔒
HTTPS with Auto SSL
Enable HTTPS for any app with one flag. SSL certs auto-generated via mkcert.

Quick Start

Get up and running in minutes

Install PortPilot

npm install -g portpilot
pnpm add -D portpilot
npm install -g portpilot@next
  1. Create .pilotrc.json in your project root:
    {
      "https": true,
      "domains": {
        "myapp.local": 3000
      }
    }
    Set "https": true to enable HTTPS with automatic SSL (requires mkcert installed globally).
  2. Start PortPilot:
    npx portpilot start
    Or just portpilot start if installed globally.
  3. Stop and clean up:
    portpilot stop