fuse host remove

Deregister a host

fuse host remove <id> [--yes]

Aliases: rm, deregister. Deregisters the host from the scheduler.

Flags

Behavior

Fails with a server error naming one of the still-assigned VMs (host prod-east-1 still has vm fuse-abc123 assigned) if any environments are still assigned to the host, drain or destroy them first. Which VM gets named is arbitrary and can differ between identical calls, so treat it as a sample rather than a count:

fuse environment list --host-id prod-east-1   # see what's still there
fuse environment destroy <id>                  # for each one
fuse host remove prod-east-1

That rejection arrives as HTTP 409 / conflict. A host with VMs still assigned is a permanent property of the request, so the call should not be retried until the environments have been drained or destroyed.

If the removed host was the active host selection for the current context, the selection is cleared automatically, you’ll need to select a new one before running host-scoped commands again.

Without --yes in an interactive terminal, prompts for confirmation first. Outside a terminal (CI, or any invocation whose stdout is piped) it aborts with aborted (use --yes to skip confirmation) rather than proceeding, so scripts must pass --yes.