Skip to content
↗ Astrona.io Cloud Native learning, open to everyone.

Astrona list

astrona list

List astrona labs (qemu VMs and kind clusters) known on this machine

Synopsis

List astrona labs (qemu VMs and kind clusters) known on this machine.

For kind labs, STATUS is live cluster health: Ready (n/n nodes Ready), NotReady (r/n), Unreachable (node containers up but the API doesn't answer), Degraded (some node containers stopped) or Stopped. -o wide adds the Kubernetes version and port-forward status; -o json prints everything for scripts.

astrona list [flags]

Options

  -h, --help            help for list
  -o, --output string   Output format: wide (adds Kubernetes version and port forwards) or json

Options inherited from parent commands

      --accept-terms      Accept this CLI's usage terms and data-loss risk notice; required on each operational CI command (read: astrona terms)
  -c, --config string     Path or URL to the lab config directory (with --git: a subdirectory within the cloned repo) (default ".")
  -f, --file string       Configuration file name override (default "config.yaml")
      --git string        Git repository URL to clone/pull (https://, git@host:, or ssh://) — --config then selects a subdirectory within it
      --git-ref string    Git branch, tag, or commit to check out (used with --git; default: the repo's default branch)
      --headless          Disable the terminal UI and CLI prompts; run/reset skip login reminders and new account sessions
      --install-version   If the lab needs another astrona release (astronaVersion) that isn't installed, install it without asking — for CI
      --trust             Approve running a remote (--git / URL) lab without asking — for CI; review the lab first
      --update-check      Check for new CLI releases (disabled in CI, without a terminal, or by ASTRONA_NO_UPDATE_CHECK) (default true)
      --verbose           Stream the full output of every underlying command instead of the compact step view

SEE ALSO

  • astrona - Astrona is the Astrona lab community CLI
Auto generated by spf13/cobra on 20-Oct-2026