UDS CLI
UDS CLI is the command-line DevX for working with the UDS ecosystem. It is the primary way to run UDS workflows from a terminal, including bundle authoring, artifact creation, deployment, publishing, cluster operations, and task automation.
Key Commands
Section titled “Key Commands”| Command | Description |
|---|---|
uds create | Build a UDS Bundle from a uds-bundle.yaml |
uds deploy | Deploy a bundle from a local file or OCI registry |
uds inspect | Inspect bundle metadata, images, SBOMs, and variables |
uds publish | Publish a bundle to an OCI registry |
uds remove | Remove a deployed bundle from a cluster |
uds run | Execute tasks from a tasks.yaml via UDS Runner |
uds monitor pepr | Stream Pepr admission and operator logs |
uds zarf | Access the vendored Zarf CLI |
Full command reference is available via uds --help and uds <command> --help.
Getting StartedInstall UDS CLI and deploy your first bundle.
How-to GuidesCommon operational patterns.
UDS CLI Next ModeWhy Next mode exists, what it currently supports, and how Next bundles work.
Schema Validation & IDE Setup
Section titled “Schema Validation & IDE Setup”UDS CLI ships with a JSON schema for uds-bundle.yaml. To enable IDE autocompletion and validation, see the schema validation docs.
Ecosystem Context
Section titled “Ecosystem Context”UDS CLI works alongside UDS Core, the platform layer providing networking, identity, security, and observability. To understand how bundles fit into the broader UDS ecosystem, see:
Get Involved