Skip to content
Fuse
Esc
navigateopen⌘Jpreview
On this page

fuse hosts list

List all registered hosts, or select an active one

List

fuse hosts
fuse hosts list

Aliases on the parent: host-list. list alias: ls. No flags beyond the globals. Both forms are equivalent, fuse hosts with no subcommand runs list.

$ fuse hosts
╭───┬─────────────┬─────────┬────────┬──────┬────────────┬────────────┬──────┬───────────╮
 ID REGION STATE CPUS RAM MB GPUS VMS LAST SEEN
├───┼─────────────┼─────────┼────────┼──────┼────────────┼────────────┼──────┼───────────┤
 * prod-east-1 us-east active 4/16 8192/65536 2/4 (a100) │ 1/20 │ 3m        │
 prod-west-1 us-west active 0/16 0/65536 - 0/20 1h
╰───┴─────────────┴─────────┴────────┴──────┴────────────┴────────────┴──────┴───────────╯

The * marks the host currently selected as active for this context.

GPUS shows allocated/capacity with the GPU model in parentheses when the host advertises one. A host with no GPU capacity renders -, so a CPU-only fleet stays readable. GPU capacity is only probed and reported on qemu hosts, a firecracker host always shows -. For per-device detail and MIG instance pools, see fuse host get and fuse host metrics.

LAST SEEN is stamped at registration and never refreshed, it is not a liveness signal and the scheduler never consults it. Judge reachability from the STATE column and the host agent’s own health endpoint instead.

Select

fuse host [id]

With an ID, validates the host exists (a GET against it) and, if so, sets it as the active host for the current context, persisted to the config file. With no ID, prints the current selection instead of changing it.

fuse host prod-east-1
# selected host "prod-east-1"

fuse host
# active host: prod-east-1

Subcommands (register, get, cordon, uncordon, remove, metrics) take precedence over selection, fuse host register ... runs the register subcommand, not a selection attempt on a host literally named register. They are registered under the plural fuse hosts as well, so neither name is a dead end.

Was this page helpful?