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

Astrona

astrona

Astrona is the Astrona lab community CLI

Synopsis

Astrona is the single CLI for the Astrona lab community: spin up local Kubernetes labs, grade them, and (as more groups land) publish and authenticate against the Astrona platform.

Astrona is free and built on donations and community support — thank you to everyone who contributes, sponsors, and helps keep it going. Donate: https://liberapay.com/Astrona.io

astrona [flags]

Options

      --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
  -h, --help              help for astrona
      --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 bundle - Pack a lab with everything it downloads, for machines without internet
  • astrona check - Check this machine can run labs (tools, container engine, a lab's memory and ports)
  • astrona content - Validate, build and scaffold course content (sections of labs)
  • astrona data - Show local file usage, clean caches, or reset CLI preferences
  • astrona destroy - Remove a lab and everything in it (and any leftover astrona test copy)
  • astrona diagnose - Collect a debugging bundle (pods, events, logs) from a running lab
  • astrona docs - Read the lab's docs (task, hints, prerequisites, solution) in the terminal
  • astrona doctor - Find out why something isn't working: this machine, the lab config and the running lab
  • astrona images - Inspect astrona's local qemu base image cache
  • astrona init - Create a new lab to start writing from
  • astrona kubeconfig - Print the path of a kind lab's own kubeconfig
  • astrona labs - Browse the lab catalog: trainings and their labs, runnable by name
  • astrona list - List astrona labs (qemu VMs and kind clusters) known on this machine
  • astrona login - Sign in to your Astrona account (catalog labs need it)
  • astrona logout - Sign out of Astrona on this computer
  • astrona logs - Inspect the per-run logs astrona writes under ~/.astrona/logs
  • astrona net - Change network conditions of a running lab's cluster (latency, loss, partition)
  • astrona port-forward - Show and manage a kind lab's port forwards (runtime.portForwards)
  • astrona progress - Your results across every lab you've submitted
  • astrona reset - Start a lab over: destroy it and recreate it from its config
  • astrona resource - Show, copy or run the files a lab ships for you (its resources)
  • astrona run - Start a lab: create its cluster(s) or VM(s) and set it up
  • astrona settings - View and change your saved CLI preferences
  • astrona setup - Install and start what this machine needs to run labs (asks first)
  • astrona shell - Open an isolated terminal (or run one command) for a Kind lab
  • astrona ssh - SSH into a running qemu lab's VM
  • astrona start - Resume a kind lab paused with astrona stop
  • astrona status - One-screen overview of a lab: health, access, exam clock, last result
  • astrona stop - Pause a kind lab (frees CPU/RAM, keeps everything) — resume with astrona start
  • astrona submit - Submit the lab to the Proctor for grading
  • astrona terms - Read the CLI usage terms and data-loss risk notice
  • astrona test - Run the full lab lifecycle for CI: bootstrap, testing, submit, teardown
  • astrona ui - Open the UI home with active runs and history
  • astrona upgrade - Upgrade astrona-cli to the latest version
  • astrona use - Pick the lab every other command works on (like kubectl's current context)
  • astrona validate - Check a lab config for mistakes without running anything
  • astrona versions - Install and list older astrona versions, for labs that need one
  • astrona whoami - Show which Astrona account this computer is signed in to
Auto generated by spf13/cobra on 20-Oct-2026