Features
Multiple TLDs
Use .local, .test, .dev or any custom TLD. Configure up to 10 different TLDs for your domains.
Built-in HTTPS
Self-signed CA with one-click trust. No external proxy like Caddy or Nginx needed.
Docker Integration
Auto-detect running containers and map them to domains. Works with container ports automatically.
Remote Hosts
Proxy to remote IPs or SSH tunnels. Access internal services through local domains.
Cross-Platform DNS
Native DNS support: dnsmasq (macOS), systemd-resolved (Linux), Acrylic (Windows), or hosts file fallback.
Full CLI & Service
Complete CLI with shell completion. Auto-start on boot via LaunchD (macOS) or systemd (Linux).
Installation
One command to get started
curl -fsSL https://locado.hxd.app/install.sh | bash locado domain add myapp.local localhost:3000 locado service start FAQ
Does it require Caddy or Nginx?
No. Locado has a built-in Go reverse proxy with SSL support. No external dependencies required.
Can I use multiple TLDs?
Yes! You can configure up to 10 different TLDs like .local, .test, .dev, or any custom TLD you prefer.
Does it work on Windows?
Yes. Locado supports Windows via Acrylic DNS Proxy. It also works on macOS (dnsmasq) and Linux (systemd-resolved).
How do I auto-start on boot?
Run 'locado service enable' to configure auto-start. Uses LaunchD on macOS and systemd on Linux.
How do I completely uninstall?
Run 'locado uninstall --purge' to remove all files, configurations, DNS settings, and certificates.
Is HTTPS really automatic?
Yes. Locado generates a self-signed CA and certificates automatically. Run 'locado cert trust' to add the CA to your system keychain.
Binary killed immediately after install (macOS)?
This is caused by macOS Gatekeeper quarantine. Run: sudo xattr -cr /usr/local/bin/locado
DNS setup from dashboard doesn't work?
DNS operations require root privileges. Run the install script in terminal: curl -fsSL https://locado.hxd.app/install.sh | bash
Changelog
-
fix(darwin): DNS detection and install improvements
-
fix(cert): ensure absolute CA path and add Windows support -
fix(install): use cp instead of mv for more robust installation
-
docs: add M4 to supported Apple Silicon list -
fix(updater): normalize version format with v prefix -
fix(updater): use current binary version instead of cached version -
fix(install): use printf for ANSI colors in success message -
fix(service): add WorkingDirectory to service templates -
feat(install): auto-install dnsmasq and service setup -
fix(service): improve error message when service not installed -
fix: replace go-sqlite3 with pure Go sqlite driver -
feat(ui): add UpdateBadge to dashboard header -
chore: remove landing page and public-repo-content from source repo -
chore: archive completed plans (remove from tracking) -
Merge public repo initial commits (keep local README) -
feat(dashboard): add UI assets and update project documentation -
refactor(ui): update dashboard theme from cyan to orange/red accent -
docs: add public repo content files -
docs: add README, LICENSE, and install script -
Initial commit