Skip to content

labops vm

Manage virtual machines.

Usage:

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

Options:

  • --help: Show this message and exit.

Commands:

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

labops vm setup

Set up a VM (initial provisioning).

Installs the base packages and applies the common host role over SSH. Run once per guest; vm update is what you run afterwards.

Examples:

labops vm setup fr24-radar        # by name
labops vm setup 10.0.50.149       # by IP

Usage:

$ labops vm setup [OPTIONS] {target}

Arguments:

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

Options:

  • --help: Show this message and exit.

labops vm update

Run the package manager upgrade on a target VM or all VMs.

Guests with os: unmanaged are skipped. Respects global --dry-run (Ansible check mode) and --verbose.

Examples:

labops vm update fr24-radar
labops vm update --all
labops --dry-run vm update --all   # check mode, changes nothing

Usage:

$ labops vm update [OPTIONS] [target]

Arguments:

  • target: VM name or IP address.

Options:

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

labops vm list

List all VMs defined in the config, grouped by their host.

Reads the config only — nothing is contacted, so this works offline and against guests that are powered down.

Usage:

$ labops vm list [OPTIONS]

Options:

  • --help: Show this message and exit.