KO
|
EN
gitlite — search
Search
#python
#javascript
#ai
#react
#tailwindcss
#deep-learning
#typescript
#linux
#nodejs
#docker
#mongodb
#programming
portero
★ 52
Open GitHub ↗
No description available.
Download README (.md)
Explore Similar Repositories
azure-cnab-quickstarts
:
CNAB packages to deploy applications from Azure to anywhere at all. Including Azure.
weibo-porter
:
微博搬运姬，自动搬运B博动态至微博的机器人
VB6Porter
:
& Visual Basic for Applications 6.5 IDE & VBAPorter
node-snowball
:
This stemmming module for Node.js provides stemming capability for a variety of languages using Dr. M.F. Porter's Snowball API.
porter2
:
High Performance Porter2 Stemmer
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
portero
?
Download (.md)
<p align="center"> <a href="https://porteroapp.pages.dev"> <img src="docs/media/1-hero.png" alt="Portero: every open port on your Mac, explained" /> </a> </p> <p align="center"> <a href="https://porteroapp.pages.dev">Website</a> · <a href="https://github.com/ctresb/portero/releases/latest">Download</a> · <a href="https://porteroapp.pages.dev/faq">FAQ</a> </p> ## 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. <p align="center"> <img src="docs/media/2-plain-words.png" alt="Portero explains each process in plain words" /> </p> ## Install Grab the latest `.dmg` for your Mac (Apple Silicon or Intel) from the [Releases](../../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 directory, parent process, and a plain-language description of what it is. 3. Use the filter tabs (All, System, Apps, Terminal, Other, Favorites, Conflicts) or the search box to find what you're looking for. 4. Click **Kill** on a row to stop a process. You'll get a confirmation dialog with the choice between a graceful stop and a forced kill. <p align="center"> <img src="docs/media/3-conflicts-kill.png" alt="Portero detects port conflicts and confirms every kill" /> </p> 5. Click the lock icon to block a port's traffic through the macOS firewall. macOS will ask for your administrator password. <p align="center"> <img src="docs/media/4-firewall.png" alt="Portero blocks ports using the built-in macOS pf firewall" /> </p> 6. Click the globe icon (shown only when the port serves HTTP) to open that server in your browser. 7. Star anything you never want to kill by accident. 8. Open **Settings** (gear icon) to change the language, toggle interface sounds, adjust the refresh interval, or reapply firewall rules. <p align="center"> <img src="docs/media/5-open-source.png" alt="Portero is free, open source, and available in English and Portuguese" /> </p> > **Note:** pf firewall rules do not survive a reboot, but Portero remembers your blocks. After restarting your Mac, open Settings and click **Reapply rules**. ## How it works Portero is a native macOS app built with [Tauri 2](https://tauri.app). The Rust backend shells out to standard system tools: - `lsof` and `ps` to discover listening ports and enrich them with process details - `pfctl` to manage firewall rules inside a dedicated `com.apple/portero` anchor, which the stock `/etc/pf.conf` already references, so no system file is ever modified - `osascript` to request administrator privileges only when applying firewall changes The frontend is React 19 + TypeScript + Tailwind CSS 4. ## Build from source Requirements: macOS, [Rust](https://rustup.rs), [Node.js](https://nodejs.org) 22+, and [pnpm](https://pnpm.io). ```sh pnpm install # run in development mode pnpm tauri dev # build a release bundle (.app / .dmg) pnpm tauri build ``` Tagged pushes (`v*`) also build automatically on GitHub Actions for both Apple Silicon and Intel, and publish a release with the bundles attached. ## License No license yet.
