Zuko
Private remote shells for machines you own—without inbound ports or a VPN.
zuko’s supported core is a Linux/macOS host and Rust CLI. Iroh handles dial-by-key reachability, relay fallback, NAT traversal, and encrypted transport; zuko handles a real PTY, one-time-code pairing, client authorization, and short reconnects.
Start here
- Install and connect on Linux or macOS.
- Run the Linux host under WSL2 on Windows, with the documented lifecycle limits.
- Download a client or build one from a fresh clone.
Use tmux, zellij, or screen for durable work. zuko deliberately does not
store detached output or promise that PTYs survive a host restart.
Useful commands:
zuko ls
zuko rm <name>
zuko reset
zuko doctor
zuko upgrade --check
zuko app --doctor
Read next
- Host operations
zuko app(Labs)- Wire protocol for client authors
- Direction and roadmap
- Releasing
- Security
The shared Flutter client is the sole graphical client implementation. Android,
iOS/iPadOS, macOS, and Linux are Beta; the
web client and Windows bundle remain Labs because
their browser and installer/upgrade gates are incomplete. zuko app is also
Labs. See Clients for current delivery channels and the
roadmap for remaining promotion gates.
Source: github.com/adonm/zuko.