flyctl machine wait waits for a machine state
Introduced 2026-03-09 · score 0.96
HOW TO USE IT
When a CLI workflow needs to wait for a Fly Machine to reach a state, run `fly machine wait <machine-id>`; it waits for `settled` by default. Use `--state <state>` to select a target and `--wait-timeout <duration>` to set the timeout.
fly machine wait <machine-id>fly machine wait <machine-id> --state <state>fly machine wait <machine-id> --state <state> --wait-timeout <duration>WHY THIS HELPS
Wait for a machine to reach a target state or settle during a CLI workflow.
REQUIREMENTS AND LIMITATIONS
- Version: v0.4.20
- machine-id: Optional positional machine ID; command allows zero or one argument and selects a machine when omitted.
- --state: Machine state to wait for; defaults to `settled`.
- --wait-timeout: Duration to wait for the machine to reach the requested state; defaults to 5 minutes. Shorthand: `-w`.
- Prerequisite: Requires an authenticated flyctl session.
FIRST-PARTY EVIDENCE
- https://github.com/superfly/flyctl/releases/tag/v0.4.20
- https://github.com/superfly/flyctl/pull/4765
- https://github.com/superfly/flyctl/blob/v0.4.20/internal/command/machine/wait.go
Check the installed version and the source before using it. Entry JSON