## pyre admin hubs

Add, build, promote, demote and remove hubs

### Synopsis

A hub is a Debian host running the storage tier. The first hub is built
with "bootstrap"; further hubs are added ("add" after "scan") and built
from the primary ("build"). One hub is primary; "promote" makes another
one primary, "demote" turns an old primary into a replica.

```
pyre admin hubs [flags]
```

### Options

```
  -h, --help   help for hubs
```

### Options inherited from parent commands

```
      --api string       API base URL (default from the profile, or https://api.pyredata.io)
      --ca-cert string   PEM file with an extra CA to trust (self-hosted managers)
      --insecure         skip TLS certificate verification (lab use only)
  -o, --output string    output format: table, json or plain (default "table")
      --profile string   config profile to use (see: pyre config)
  -q, --quiet            print results only, no notices
      --token string     API token (default from the profile; prefer PYRE_TOKEN in scripts)
  -y, --yes              answer yes to every confirmation (for scripts)
```

### SEE ALSO

* [pyre admin](pyre_admin.md)	 - Operator commands: hubs, users, tenants
* [pyre admin hubs accept-deletions](pyre_admin_hubs_accept-deletions.md)	 - Let a replica's next data pass mirror a primary that shrank (one pass)
* [pyre admin hubs add](pyre_admin_hubs_add.md)	 - Register a hub host (scan first; the fingerprint must match)
* [pyre admin hubs bootstrap](pyre_admin_hubs_bootstrap.md)	 - Build the very first hub (no primary exists yet)
* [pyre admin hubs bootstrap-forget](pyre_admin_hubs_bootstrap-forget.md)	 - Forget a failed bootstrap so it can be retried
* [pyre admin hubs bootstrap-status](pyre_admin_hubs_bootstrap-status.md)	 - Show a bootstrap build's progress
* [pyre admin hubs build](pyre_admin_hubs_build.md)	 - Build (or rebuild) a hub from the primary
* [pyre admin hubs build-status](pyre_admin_hubs_build-status.md)	 - Show a running or finished build
* [pyre admin hubs demote](pyre_admin_hubs_demote.md)	 - Turn a former primary into a replica of --peer
* [pyre admin hubs enable](pyre_admin_hubs_enable.md)	 - Enable or disable a hub for placement
* [pyre admin hubs list](pyre_admin_hubs_list.md)	 - List hubs with role and health
* [pyre admin hubs onboard-key](pyre_admin_hubs_onboard-key.md)	 - Print the block a new hub must run before it can be built
* [pyre admin hubs onboard-revoke](pyre_admin_hubs_onboard-revoke.md)	 - Revoke a hub's onboarding key on the primary
* [pyre admin hubs poll](pyre_admin_hubs_poll.md)	 - Poll a hub's health now
* [pyre admin hubs preflight](pyre_admin_hubs_preflight.md)	 - Check a host before building it (network, packages, ports)
* [pyre admin hubs promote](pyre_admin_hubs_promote.md)	 - Make a replica the primary (planned failover or DR)
* [pyre admin hubs promote-status](pyre_admin_hubs_promote-status.md)	 - Show the promotion in progress (or the last one)
* [pyre admin hubs remove](pyre_admin_hubs_remove.md)	 - Decommission a hub
* [pyre admin hubs replication](pyre_admin_hubs_replication.md)	 - Show replication lag between the primary and each replica
* [pyre admin hubs rescan](pyre_admin_hubs_rescan.md)	 - Re-read a hub's SSH host key
* [pyre admin hubs scan](pyre_admin_hubs_scan.md)	 - Fetch a host's SSH key fingerprint before adding it
* [pyre admin hubs set-address](pyre_admin_hubs_set-address.md)	 - Move a hub to a new address (scan first; the fingerprint must match)