Skip to content

labops host

Manage bare-metal hosts.

Usage:

$ labops host [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • setup: Set up a host (initial...
  • update: Run the package manager...
  • list: List all hosts defined in the...

labops host setup

Set up a host (initial provisioning).

Installs the base packages and applies the common role over SSH, using settings.default_creds unless the node overrides them. Run once per host; host update is what you run afterwards.

Examples:

labops host setup cprox           # by name
labops host setup 10.0.10.3       # by IP

Usage:

$ labops host setup [OPTIONS] {target}

Arguments:

  • target: Host name or IP address as defined in the homelab config. [required]

Options:

  • --help: Show this message and exit.

labops host update

Run the package manager upgrade on a target host or all hosts.

apt, apk or dnf, chosen by each node's os. Nodes with os: unmanaged are skipped. Respects global --dry-run (Ansible check mode) and --verbose.

Examples:

labops host update cprox
labops host update --all
labops --dry-run host update --all   # check mode, changes nothing

Usage:

$ labops host update [OPTIONS] [target]

Arguments:

  • target: Host name or IP address.

Options:

  • --all: Update all hosts.
  • --help: Show this message and exit.

labops host list

List all hosts defined in the config.

Reads the config only — nothing is contacted, so this works offline and against hosts that are powered down. Guests are not shown; see vm list and lxc list.

Usage:

$ labops host list [OPTIONS]

Options:

  • --help: Show this message and exit.