Meet HomeportEvery local project, one home
Run, watch and share all your dev servers from one place — any stack, free and open source.
Free · macOS, Windows & Linux · Install guide
macOS (.dmg) Windows (.exe) Linux (.AppImage) Debian/Ubuntu (.deb)
curl -fsSL https://raw.githubusercontent.com/ferdousmikdad/Homeport/main/install.sh | sh
irm https://raw.githubusercontent.com/ferdousmikdad/Homeport/main/install.ps1 | iex
Prefer the terminal? It installs the same app and skips the “unverified developer” prompt.
Applications
3 runningFeatures
Everything your local stack needs.Nothing it doesn't.
No config files, no accounts. Point Homeport at a folder and it does the rest.
It works out how to run your project.
Pick a folder — or a whole ~/Projects directory — and Homeport detects the framework, package manager, virtualenv and a free port.
- Installs missing dependencies on first start
- Named URLs:
shop.localhost:7777instead of port numbers - Workspaces start API → frontend → worker in order
Do anything in two keystrokes.
Press ⌘K (or Ctrl K) and type. Fuzzy search across every app and action — start, stop, logs, share, open on phone, add a database.
- Context-aware: running apps offer Stop, crashed ones offer “Why?”
- Fully keyboard-driven, updates live
Open it on your phone. Scan, done.
Turn on Wi-Fi preview and scan the QR code — your app opens on any device on the same network, live reload and all.
- Only the app you choose is exposed, only while it's on
- QR codes for public links too
Crashed? Click “Why?”.
Homeport reads the log and explains it in plain words — port in use, missing packages, no .env, database down — with one-click fixes. Works offline.
- Install packages, create
.env, free a port, add a database - Optional AI assistant if you use Claude Code
Install the project's requirements into its own environment (.venv).
ModuleNotFoundError: No module named 'redis'
Install Python packages
Databases are just apps.
PostgreSQL, MySQL/MariaDB, Redis, MongoDB and Mailpit in one click — using what's already on your computer, or Docker. Copy the connection URL or ready-made .env lines.
- Picks free ports, keeps data in its own folder
- Start, stop, logs and auto-restart like any app
Works with
Whatever you build with.Detected automatically.
Anyone can teach it a new framework with a small JSON recipe.
And more
Small things that add up.So the day just flows.
Why Homeport
One tool instead of five.Built for the projects you already have.
Most tools cover one slice. Homeport covers the whole loop: run, watch, share, fix.
| Homeport | Stack-specific apps | Tunnel tools | Terminal tabs | |
|---|---|---|---|---|
| Any language / framework | ✓ | One stack | — | ✓ |
| Detects how to run a project | ✓ | Partly | — | — |
| Dashboard, logs, CPU/memory | ✓ | Partly | — | — |
| Public links with password & expiry | ✓ free | Some, often paid | Often paid | — |
| Phone preview with QR | ✓ | — | — | — |
| Crash explanations & fixes | ✓ | — | — | — |
| Databases as one-click apps | ✓ | ✓ | — | — |
| macOS, Windows & Linux | ✓ | Varies | ✓ | ✓ |
| Open source, no account | ✓ | Varies | Varies | ✓ |
Open source
Yours to use, change and improve.MIT-licensed, built in the open.
Homeport runs entirely on your computer — no telemetry, no account, nothing to pay. Teach it a new framework with one JSON file, report a bug, or send a pull request.
Questions
Is Homeport really free?
Yes. It's open source under the MIT license, needs no account and runs entirely on your computer. Public share links use Cloudflare's free, account-less Quick Tunnels.
Do I need to install Python or anything else first?
No. The launcher uses Python if you have it; if not, it downloads a private copy into the Homeport folder — no admin rights, nothing system-wide. Your own projects still use their own tools (Node, PHP, …).
Which systems does it run on?
macOS, Windows and Linux. Double-click run.command on macOS, run.bat on Windows, or run ./run.sh on Linux.
Can other people on my network control my apps?
No. The dashboard only listens on your own computer. Phone preview exposes just the one app you choose, on your local network, until you turn it off.
How do share links stay safe?
You can add a password (only a salted hash is kept) and an expiry. Links also close when you stop sharing, stop the app or quit Homeport.
My framework isn't detected. What now?
Type your start command once — Homeport remembers it. Or add a small JSON recipe so it's detected for everyone; see the docs.
Give your projects a home.Download, double-click, done.
Free and open source, for macOS, Windows and Linux.