Host

Upgrade or reinstall Host

Product CLI is termee. Upgrade = stop → replace binary → connect. Profiles under ~/.termee/hosts/ keep your pairing.

Day-to-day commands

termee setup
termee pair <code>
termee connect
termee status
termee stop

Build

make build-linux-host
# → dist/termee-linux-amd64  (and arm64)
make build-windows-host
# → dist/termee-windows-amd64.exe
CGO_ENABLED=0 go build -o dist/termee-darwin ./cmd/host-agent

Fresh install (Linux)

# On build machine
make build-linux-host
scp dist/termee-linux-amd64 USER@HOST:~/termee-linux-amd64

# On the Host
mkdir -p ~/bin
install -m 0755 ~/termee-linux-amd64 ~/bin/termee
# optional: ln -sfn ~/bin/termee-YYYYMMDD ~/bin/termee
export PATH="$HOME/bin:$PATH"

termee setup --name=default --relay=wss://staging.termee.ai/ws --code=PASTE_CODE --start --yes
termee status

Upgrade (keep config)

termee stop --name=default

scp dist/termee-linux-amd64 USER@HOST:~/termee-linux-amd64
ssh USER@HOST 'install -m 0755 ~/termee-linux-amd64 ~/bin/termee && termee connect --name=default && termee status --name=default'

curl -sS https://staging.termee.ai/healthz
# Expect connections >= 1 when a Host is online

Replacing the binary does not wipe ~/.termee/hosts/<name>.json. Do not run legacy nohup host-agent -connect alongside termee connect for the same token.

Multi-profile

~/.termee/hosts/<name>.json
~/.termee/run/<name>.pid
~/.termee/run/<name>.log

termee setup --name=home --code=CODE1 --start --yes
termee setup --name=lab  --code=CODE2 --start --yes
termee status --name=home
termee stop --name=lab

Platform notes

Staging checks

• Health: https://staging.termee.ai/healthz
• Prefer WSS hostname: wss://staging.termee.ai/ws
• Bare IP co-debug uses HTTP (no IP TLS): http://13.228.73.229/web/docs/host-upgrade.html

Full CLI reference →