CLI Reference

SmoothGlue CLI — v7.5.0 latest / v7.3.0 stable. Written in Go. macOS and Linux only. No Windows support.

Installation

Download the binary from the SmoothGlue portal. Add to your PATH.

# Verify installation
smoothglue version

Command	Description
`smoothglue configure`	Interactive TUI wizard to create or edit `platform.yaml`
`smoothglue install`	Run the 9-stage install state machine (resumable)
`smoothglue status`	Show current platform health and service URLs
`smoothglue destroy`	Tear down the platform and de-provision infrastructure
`smoothglue package`	Create a Zarf bundle for air-gap delivery
`smoothglue upgrade`	Upgrade platform components to a new version
`smoothglue version`	Print CLI version

Launches an interactive TUI wizard (Charmbracelet) to create or edit platform.yaml.

Flag	Default	Description
`--template`	(interactive)	Platform template: `build`, `run`, or `edge`
`--provider`	(interactive)	Cloud provider: `aws` or `kvm`
`--output`	`platform.yaml`	Output file path
`--non-interactive`	`false`	Skip TUI, require all flags

Runs the 9-stage install state machine. Resumable — re-run the same command to continue from the last successful stage.

Flag	Default	Description
`--config`	`platform.yaml`	Path to config file
`--stage`	(resume from last)	Force start at a specific stage (1–9)
`--dry-run`	`false`	Validate config without executing
`--timeout`	`60m`	Per-stage timeout

Stage	Name	What it does
1	Validate	Config validation, prerequisite checks
2	Network	VPC, subnets, security groups
3	Cluster	EKS/RKE2/KVM cluster provisioning
4	Bootstrap	Flux, cert-manager, external-secrets install
5	Platform	Big Bang + SmoothGlue packages deploy
6	Identity	Keycloak realm, clients, SSO wiring
7	Apps	Selected optional apps deploy
8	Validation	Health checks on all deployed services
9	Output	Print access URLs and credentials