Skip to content

ksail project env list

List the cluster environments declared in the workspace.
An environment is a ksail.<name>.yaml root config in the workspace root. The base
ksail.yaml declares one too when its spec.workload.kustomizationFile syncs a
clusters/<name> overlay — the initial environment "project init --multi-cluster"
scaffolds. These are the same environments "project env add"'s --from and
"project env reconcile" resolve against. Each declared environment is reported
with its distribution and provider, read from its config. A config that fails to
load is skipped so a single malformed file never hides the environments that do
load.
Output Format:
NAME DISTRIBUTION PROVIDER CONFIG
local Vanilla Docker ksail.yaml
prod Talos Hetzner ksail.prod.yaml
staging K3s Docker ksail.staging.yaml
Use --output json for machine-readable output. The JSON is an array of objects:
[
{"name": "prod", "distribution": "Talos", "provider": "Hetzner", "config": "ksail.prod.yaml"}
]
Examples:
# List the declared environments
ksail project env list
# Machine-readable JSON
ksail project env list --output json
Usage:
ksail project env list [flags]
Aliases:
list, ls
Flags:
--output string Output format: text or json. Use json for machine-readable output (array of {name, distribution, provider, config}). (default "text")
Global Flags:
--benchmark Show per-activity benchmark output
--config string Path to config file (default: ksail.yaml found via directory traversal)
--experimental Enable experimental (unstable) commands and features