🚀 PortPilot

Pilot your ports like domains, effortlessly map local apps to custom domains — no admin headaches.

Features

Built for modern local development

🔗 Custom Domain Mapping: Instantly bind your local ports to domains like myapp.local.
🧠 No Hosts File Editing: No need to touch /etc/hosts — we handle it automatically.
🖥️ Cross-Platform Support: Works on macOS, Windows, and Linux — with auto-setup.

Quick Start

Get up and running in minutes

1. Install PortPilot

pnpm add -D portpilot

2. Create .pilotrc.json

{
  "apps": [
    {
      "domain": "myapp.local",
      "port": 3000,
      "https": false
    }
  ],
  "on": {
    "stop": {
      "cleanNginx": true,
      "cleanHosts": true,
      "cleanConfigs": true
    }
  }
}

3. Run PortPilot

npx portpilot start