Installation
Install the Hostess CLI on macOS, Linux, or Windows and verify your installation.
The Hostess CLI is a single static binary. The supported install path is the install script at install.sh, which detects your OS and CPU architecture and downloads the matching release from GitHub.
Install
macOS / Linux (bash-compatible shell):
curl -fsSL https://hostess.sh/install.sh | shBy default the binary is placed in ~/.local/bin/hostess. If that directory is not on your PATH, the script prints the export PATH=... line to add.
Windows: Use Git Bash, WSL, or another environment where curl and sh are available, and run the same command. Alternatively, download the appropriate hostess-windows-{arch}.exe asset from the hostess-cli releases and add it to your PATH as hostess.exe.
Supported platforms
Release binaries are built for macOS (darwin) and Linux on amd64 and arm64, and for Windows on amd64 and arm64. The install script handles macOS and Linux automatically; Windows users typically use WSL or a manual download.
Verify your installation
hostess --versionYou should see something like hostess version 0.1.x; the exact number matches the release you installed.
If you see command not found, ensure the install directory (often ~/.local/bin) is on your PATH.
Updating
Run the update command. It fetches the latest release and replaces the existing binary:
hostess updateUninstalling
Remove the hostess binary and optionally the configuration directory:
rm -f ~/.local/bin/hostess
rm -rf ~/.hostessOn Windows, delete the binary you installed and remove %USERPROFILE%\.hostess if present.
Next steps
After installing, log in and follow the Quick Start to deploy your first application.