Install the agent
The agent is a single static Go binary (~10–15 MB), idling at ~15 MB RAM. It has no runtime dependencies and cross-compiles for amd64/arm64.
Requirements
Section titled “Requirements”- Ubuntu 24.04 LTS
- 1 CPU / 1 GB RAM minimum
- Outbound HTTPS:443 open (no inbound needed)
Install
Section titled “Install”curl -fsSL https://get.mzpanel.com | bash -s -- --token=<install-token>The script downloads the binary, creates a systemd unit mzagent.service, then
registers with the control plane using the install token (1-hour TTL).
Authentication
Section titled “Authentication”| Stage | Token |
|---|---|
| First registration | install token (one-time, 1h TTL) |
| Steady state | long-lived agent token (rotated when the license changes) |
The license verdict is cached at /etc/mzagent/license.json with a 7-day offline
grace — the agent keeps running if the control plane is briefly unreachable.
Uninstall
Section titled “Uninstall”mz agent uninstall