Documentation Index
Fetch the complete documentation index at: https://mintlify.com/getployz/ployz/llms.txt
Use this file to discover all available pages before exploring further.
ployzctl is the primary operator interface for Ployz. It wraps ployzd, the control plane daemon, and forwards all commands to it over a local Unix socket. Every operation is an explicit command with visible preconditions, a bounded effect, and a structured result — no background reconcilers, no desired-state drift.
How ployzctl works
ployzctl has one native subcommand (daemon) and forwards everything else to ployzd. When you run ployzctl machine ls, ployzctl locates the ployzd binary next to itself and invokes it with the remaining arguments. This means global flags and all subcommands documented here are handled by ployzd.
Global flags
These flags apply to every command and must be placed before the subcommand.Path to the Ployz configuration file. Overrides the default location resolved from the data directory.
Override the data directory used by the daemon. Useful when running multiple daemon instances on the same host.
Override the Unix socket path used to reach the running daemon. Defaults to the path resolved from the config or data directory.
Print the full daemon response as JSON. Suitable for scripting and automation. Conflicts with
--plain.Print compact human-readable text with fewer tokens and less formatting. Conflicts with
--json.Suppress success output where possible. Errors are still printed to stderr.
Output modes
Ployz supports three output modes to fit different operator workflows.- Default
- --json
- --plain
Formatted, human-readable output. Tables, labels, and status summaries. Best for interactive use.
--json and --plain are mutually exclusive. Passing both flags is an error.Top-level commands
machine
Add, remove, inspect, and lifecycle-manage cluster nodes. Includes invite tokens and storage promotion.
deploy
Apply deploy manifests or deploy a single service inline. Includes dry-run and preview modes.
branch
Fork namespaces for PR environments. Control which resources are copied and which are fresh.
migrate
Move a workload and its persistent volumes to a different machine. Uses ZFS incremental send.
mesh
Manage WireGuard overlay networks. Create, join, start, stop, and inspect mesh networks. Also available as
network.image
Push and distribute container images to cluster nodes. Inspect image availability and operations.
build
Build container images locally using Dockerfile or Railpack. Inspect build operations.
Additional commands
| Command | Description |
|---|---|
run | Start the ployzd daemon process directly. Accepts --runtime, --service-mode, and --zfs-transfer-port. |
status | Show the current daemon and cluster status. |
doctor | Run preflight checks and diagnose common configuration problems. |
runtime stream | Stream runtime events from the daemon. |
The daemon install command
daemon install is the one command handled natively by ployzctl rather than forwarded to ployzd. It installs or reconfigures the local daemon runtime.
The container runtime target.
docker uses the Docker engine; host runs workloads directly on the host.Whether the daemon service is installed as a user-level or system-level service.
Optional path to a custom install manifest file.
Error handling
When a command fails, ployzctl prints a structured error to stderr and exits with a non-zero code:- Exit 1 — I/O error, serialization failure, daemon error, or transport failure (daemon not reachable).
- Exit 2 — Usage error or configuration error.