PortPilot

Localhost Port Manager for Developers

Scan active ports, kill stuck processes, register your dev apps, and take control of your local development environment. Free and open source.

Windows 10/11 & Linux | v1.6.2 | MIT Licence

Features

🔍

Browse & Auto-detect

One-click project setup with package manager detection.

⚠️

Port Conflict Warnings

Visual warnings when unknown processes block app ports.

Favorites System

Star frequently-used apps for quick access.

🐧

Cross-Platform

Works on Windows 10/11 and Linux (AppImage + .deb).

Port Scanner

Scan all TCP ports with process name, PID, and command line.

One-Click Kill

Free up stuck ports instantly without Task Manager.

Process Control

Start/stop apps with automatic port detection.

🐳

Docker

Detect Docker apps, launch Desktop with one click.

5 themes

TokyoNight, Brutalist, Nord, Dracula, and more.

🖥️

System Tray

Stop all apps from tray menu, configurable window behaviour.

🔒

Single Instance

Only one PortPilot runs at a time, focuses existing window.

Knowledge Base

Everything you need to know about PortPilot

⚙️ How It Works

PortPilot scans your system for active TCP ports using native OS commands.

  • Scans via netstat (Windows) or lsof (Mac/Linux)
  • Shows process name, PID, and command line
  • One-click kill for stuck processes
  • Register apps with preferred ports

🚀 Quick Start

  1. Scan Ports — Click the button to discover active ports
  2. Add Apps — Register your dev projects with start commands
  3. Start/Stop — Control apps from the My Apps tab
  4. Kill Ports — Free up stuck ports with one click

🔌 Common Dev Ports

3000 React, Next.js, Express
4200 Angular CLI
5173 Vite
5432 PostgreSQL
6379 Redis
8000 Django, FastAPI
8080 Tomcat, Live Server
27017 MongoDB

🏷️ App Badges

PortPilot auto-detects app requirements and shows badges:

🐳 Docker — Click to start Docker Desktop
📦 Node.js — npm, yarn, pnpm, bun
🐍 Python — uvicorn, flask, django
🔶 Go — Gin, Fiber, Echo
.NET — ASP.NET Core
🦀 Rust — Actix-web, Rocket, Axum, Warp
💎 Ruby — Rails, Sinatra, Rack
🗃️ Database — postgres, mysql, redis
Auto-start — Launches on app startup

💻 System Tray

PortPilot lives in your system tray for quick access:

  • Left-click — Show/hide window
  • Right-click — Menu: Show, Scan Ports, Stop All Apps, Quit

🐳 Docker Integration

Smart Docker Desktop integration:

  • Yellow pulsing — Docker not running
  • Green badge — Docker ready
  • Click badge — Starts Docker Desktop

🛠️ Troubleshooting

Port won't kill?

Some system processes require admin. Run PortPilot as Administrator.

App won't start?

Check working directory and command. View app logs for errors.

Docker app fails?

Make sure Docker Desktop is running. Click the yellow badge to start it.

🌐 IPv4 vs IPv6

PortPilot shows which IP protocol apps are bound to:

  • v4 — IPv4 (0.0.0.0:3000)
  • v6 — IPv6 ([::]:3000)

Browsers may prefer IPv6. PortPilot opens the correct URL.

Smart App Detection

PortPilot automatically detects app requirements and shows visual badges

🐳 Docker
📦 Node.js
🐍 Python
🔶 Go
.NET
🦀 Rust
💎 Ruby
🗃️ Database
Auto-start
🌐 Remote

Getting Started

1

Download

Get the installer from GitHub Releases.

Download v1.6.2
2

Install

Run the installer. No admin rights needed.

3

Scan Ports

Click Scan Ports to discover active ports.

4

Register Apps

Add your dev projects.

Keyboard Shortcuts

Ctrl+R Refresh
Ctrl+N Add App
Ctrl+1-4 Switch Tabs
Escape Close Modal

AI Agent Integration

Control PortPilot with natural language via MCP

Example Commands

List all my PortPilot apps
Start the azure-exam app
Kill port 3000

Compatible With

Claude Code Claude Desktop Cursor Windsurf Cline
Setup Guide

Download PortPilot v1.6.2

Free, open source, no account required

Windows

🐧 Linux

Source