LocalDNS.wtf
CLI Reference

Daemon Control

Commands for starting, stopping, and managing the LocalDNS daemon.

Daemon Control

localdns start

Start the LocalDNS daemon, or start a specific domain's process.

localdns start [domain] [options]
OptionDescription
-p, --port <port>API port (default: 1111)
-f, --foregroundRun daemon in foreground
localdns start                # Start daemon
localdns start myapp.local    # Start specific domain
localdns start --foreground   # Run in foreground

localdns stop

Stop the LocalDNS daemon (stops all managed processes).

localdns stop

localdns status

Show LocalDNS status: daemon state, registered domains, running vs stopped.

localdns status

localdns ensure

Ensure the daemon is always running. Installs a macOS launchd service if needed.

localdns ensure [options]
OptionDescription
--install-onlyOnly install the service, don't start it

localdns install

Install LocalDNS as a system service (macOS launchd).

localdns install [options]
OptionDescription
--userInstall for current user only (default)
--systemInstall system-wide (requires sudo)
--dns-onlyOnly set up DNS resolver
--skip-dnsSkip DNS resolver setup
localdns install           # User-level install
sudo localdns install --system  # System-wide install