ferdousmikdad/Homeport
ferdousmikdad/Homeport has 6 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:08 UTC. Last push 2026-11-14.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Run, watch and share every local project from one place — any stack (Laravel, Node, Python, PHP, WordPress, static…). Free, open source, no account. macOS, Windows & Linux.
Developer ToolsREADME.md
OriginalHomeport
The home for every local project you run. Start, stop, watch and share all your dev servers — Laravel, PHP, Node, Python, Rails, Go, Rust, Java, .NET, Docker, static sites and more — from one page in your browser.
Free and open source (MIT). Runs on macOS, Windows and Linux. No account, no sign-up, no cloud, nothing to pay — everything runs on your own computer.
Why Homeport
Most tools cover one slice: a PHP stack, a Node process manager, a tunnel. Homeport works with the projects you already have, whatever they're built with.
| 🔍 Finds how to run anything | Point it at a folder and it works out the start command — framework, package manager, virtualenv, free port, missing installs. |
| 🧭 Discover projects | Pick your ~/Projects folder; every project inside is detected and added in one click. |
| 🏷️ Named URLs | Open apps at http://blog.localhost:7777 instead of remembering ports. No hosts-file edits — every browser resolves *.localhost to your computer. Live reload keeps working. |
| 📱 Phone preview + QR | One switch puts an app on your Wi-Fi; scan the QR code to open it on your phone. |
| 🌍 Public links, safely | Share a running app on a free https://…trycloudflare.com link (no account). Add a password and an auto-expiry so nothing stays open by accident. Leftover localhost links in pages are fixed on the fly, so any framework works for visitors. |
| 💬 Comments on share links | Turn on visitor feedback when you share: visitors press C, click a spot and comment — like Figma comments, with replies, pins that stay put while scrolling, and a comments panel. Comments are saved in Homeport on your computer; view the site with or without them. |
| 🐙 GitHub | Connect GitHub in one click, then Add from GitHub clones a repo, works out how to run it and starts it. Cards show CI results (main ✓) and link to pull requests. Private repos too; your login stays on your computer. See docs/GITHUB.md. |
| ⌨️ Command palette | Press ⌘K / Ctrl+K and type: “stop api”, “logs blog”, “share portfolio”, “add redis”. Every action, keyboard-first. |
| 🗄️ Databases & services | PostgreSQL, MySQL/MariaDB, Redis, MongoDB and Mailpit as one-click apps — using the server already on your computer, or Docker. Copy the connection URL or ready-made .env lines. |
| 📝 WordPress mode | Drop in a WordPress site (even a copy of a live one), click Set up: database, wp-config.php and a live-URL helper are done for you. Import the .sql backup and it works on localhost, phones and share links. |
| 🧱 Workspaces | Group apps (API + frontend + worker) and start them as one — in your order, each waiting until the previous is up. |
| 🩺 Crash fixer | When an app stops, Why? reads the log and explains it in plain words — port in use, missing packages, no .env, tool not installed, database down — with one-click fixes. Works offline. |
| 🌿 Git on every card | Branch, uncommitted changes, commits to pull — and Pull & restart. |
| 🧩 Community recipes | Teach Homeport a new framework with a small JSON file — no code. See recipes/. |
| 🤖 Optional AI assistant | A chat panel that diagnoses and fixes apps. Use Claude Code if you have it, or a free local model (Qwen, Llama, Gemma) through Ollama: offline, nothing leaves your computer, and every change asks you first. Guided by step-by-step fix guides in skills/. Not required for anything else. |
Plus: Settings (theme, defaults, AI models), live CPU / memory / uptime, persistent logs with search, auto-restart on crash, start at login, port-conflict detection, drag-and-drop organising, categories, light & dark themes.
Install
Desktop app — download from the latest release:
| System | File |
|---|---|
| macOS (Apple Silicon) | Homeport-mac-arm64.dmg — drag Homeport to Applications |
| Windows 10/11 | Homeport-Setup-x64.exe (no admin rights needed) |
| Linux x86_64 | Homeport-x86_64.AppImage or homeport_amd64.deb |
Or install from the terminal (same app, and no "unverified developer" prompt):
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/ferdousmikdad/Homeport/main/install.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/ferdousmikdad/Homeport/main/install.ps1 | iex
First open of a downloaded installer. Homeport is free and isn't signed with a paid Apple/Microsoft certificate, so the system asks once:
- macOS: if it says the app "can't be opened", go to System Settings → Privacy & Security and click Open Anyway (or right-click the app → Open).
- Windows: on "Windows protected your PC", click More info → Run anyway.
The terminal install above avoids this. The installed app keeps its data in
~/Library/Application Support/Homeport,%APPDATA%\Homeportor~/.local/share/homeport.
Run from source
Nothing to install first. Download or clone this repository, then:
| System | Start Homeport |
|---|---|
| macOS | Double-click run.command (or open Homeport.app) |
| Windows | Double-click run.bat |
| Linux | Run ./run.sh |
The first start sets everything up by itself (needs internet once, usually under a minute), then opens http://localhost:7777:
- If this computer has Python 3.9+, Homeport uses it.
- If not, it downloads a private copy of Python (via
uv) into the hidden
.runtime/folder here — nothing is installed system-wide and no admin rights are needed. - It installs its few Python libraries into
.venv/in this folder.
After that, starting is instant; libraries are only reinstalled when
requirements.txt changes. Deleting the folder removes everything.
Options: --port 8000, --no-browser (e.g. ./run.sh --port 8000).
Your own projects still use their own tools (Node, PHP, …) from your system.
Start at login
| System | Install | Remove |
|---|---|---|
| macOS | scripts/install_autostart.sh |
scripts/uninstall_autostart.sh |
| Windows | scripts\install_autostart_windows.bat |
scripts\uninstall_autostart_windows.bat |
| Linux | scripts/install_autostart_linux.sh |
scripts/uninstall_autostart_linux.sh |
Privacy & cost
- Homeport only listens on
127.0.0.1— other devices can't reach the dashboard. Phone preview exposes just the one app you choose, on your local network, until you switch it off or the app stops. - Public links use Cloudflare's free, account-less Quick Tunnels via the
open-source
cloudflaredtool, downloaded on first use. Protected links ask for your password before anything reaches your app (only a salted hash is kept). - No telemetry, no analytics, no account. Your app list stays in
data/apps.jsonon your machine.
Per-system notes
- Folder picker: native dialog on macOS and Windows; on Linux
zenityorkdialogif installed, otherwise the built-in browser. - Crash notifications: Notification Center (macOS), tray balloon
(Windows),
notify-send(Linux). - Commands Homeport suggests use your system's shell syntax (
cmdon Windows,shelsewhere). You can always edit them.
Contributing
Bug reports, recipes and pull requests are very welcome — see
CONTRIBUTING.md. Adding support for a new framework is
often just one JSON file in recipes/.
.venv/bin/python -m pytest # macOS / Linux
.venv\Scripts\python.exe -m pytest # Windows
License
MIT © The Homeport contributors