Portero is a macOS app that displays all listening TCP/UDP ports with plain-language explanations and lets you manage processes, detect conflicts, and block traffic via the built-in pf firewall.

Stars

53

7-day growth

No data

Forks

6

Open issues

1

License

MIT

Last updated

2026-07-14

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves the common problem of losing track of running dev servers and services, replacing cryptic binary names with human-readable descriptions, and leverages macOS’s native firewall without modifying system files—all in a free, open-source Tauri/Rust app.

Who it is for

  • macOS developers juggling multiple projects
  • System administrators monitoring local services
  • DevOps engineers debugging port conflicts
  • Security-conscious users who want to quickly block ports

Use cases

  • Identifying which process is using a port when you get 'address already in use'
  • Gracefully or forcefully killing forgotten dev servers to free up ports
  • Blocking inbound/outbound traffic on a port for security testing
  • Quickly opening a local HTTP server in the browser from the app

Strengths

  • Plain-language explanations for hundreds of common processes and well-known ports
  • Real-time conflict detection with the ability to filter to conflicting processes
  • Built-in macOS pf firewall integration that never edits system files
  • Native performance and small footprint thanks to Tauri 2, Rust, and React

Considerations

  • Not signed with an Apple Developer certificate yet, requiring right-click → Open on first launch
  • pf firewall rules do not survive reboot (manual reapply needed via Settings)
  • No license specified in the repository

README quick start

Website · Download · FAQ

Why

When you're working on multiple projects at the same time, it's easy to lose track of what's running. A database here, a dev server there, an API you forgot was still open... before long, your ports become a mess.

Portero gives you a clear view of everything running on your machine, so you always know what's using each port, can stop what you don't need, and get back to building instead of debugging port conflicts.

What it does

  • Live port list. Every listening TCP and UDP port, refreshed automatically, with process name, PID, address, protocol, user, and start time.
  • Plain-language explanations. Portero recognizes hundreds of common processes, dev tools, and well-known ports, and tells you what each one actually is: "Vite dev server", "PostgreSQL database", "AirDrop and sharing", instead of a cryptic binary name.
  • Categories. Processes are grouped into System, Apps, Terminal (dev servers you started), and Other, so you can tell at a glance what is safe to touch.
  • Kill processes. End a process gracefully (SIGTERM) or force it (SIGKILL) when it refuses to die. Select several rows and kill them all at once.
  • Conflict detection. When more than one process listens on the same port (the classic "address already in use"), Portero flags it and lets you filter straight to the conflicts.
  • Block ports. Block inbound and/or outbound traffic on any port using the built-in macOS firewall (pf). Rules live in a dedicated anchor, no system files are edited.
  • Open in browser. When a port answers HTTP (a frontend or dev server), a globe button appears to open it directly in your browser.
  • Favorites. Star a process to protect it. Favorited processes cannot be killed until you unstar them.
  • Search, filter, and sort by port, process, path, command line, or PID.
  • Two languages. English and Portuguese, switchable in Settings.

Install

Grab the latest .dmg for your Mac (Apple Silicon or Intel) from the Releases page, open it, and drag Portero to Applications.

Builds are not signed with an Apple Developer certificate yet. The first time you open the app, right-click it in Applications and choose Open.

How to use

  1. Open Portero. The table shows every listening port on your machine.
  2. Click a row to expand it and see the full command line, working dir

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
vercel-labs
Featured
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

Developer ToolsCode Quality & Build
1,985
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191