Install
devhost is a single binary. Download it, put it on your PATH, and prepare Caddy once per machine.
Download the binary
Section titled “Download the binary”Every release has an archive for each platform:
| Platform | Archive suffix |
|---|---|
| macOS, Apple silicon | darwin-arm64 |
| Linux, x86-64 | linux-x64 |
| Linux, ARM64 | linux-arm64 |
| Linux, x86-64, musl (Alpine) | linux-x64-musl |
| Linux, ARM64, musl (Alpine) | linux-arm64-musl |
This installs the latest release. Set platform to your archive suffix:
platform=darwin-arm64tag=$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/alexgorbatchev/devhost/releases/latest | sed 's#.*/##')curl -fsSL "https://github.com/alexgorbatchev/devhost/releases/download/$tag/devhost-$tag-$platform.tar.gz" | tar -xzsudo install "devhost-$tag-$platform/devhost" /usr/local/bin/devhostdevhost --versionAny directory on your PATH works in place of /usr/local/bin.
Prepare Caddy
Section titled “Prepare Caddy”devhost routes every hostname through one shared Caddy server:
devhost caddy download # skip if `caddy` is already on your PATHdevhost caddy privileged-ports # Linux only: lets Caddy use port 443 without rootdevhost caddy startThe first start installs Caddy’s local certificate authority into your system trust store and can ask for your password. See Route apps over HTTPS for details.
Optional extras
Section titled “Optional extras”- Browser chat needs an installed, signed-in Codex CLI or Claude Code. See Chat with a coding agent.
- Shell completion:
source <(devhost completion zsh), orbash,fish,powershell. See the CLI reference. - Coding agents:
npx skills add alexgorbatchev/devhost --skill devhost -yinstalls the devhost skill, which teaches agents every command and manifest rule. SetAGENT=1when an agent reads devhost’s output; see Terminal output.
Run a stack from a devhost.toml, or serve a folder or a port without one.