Crossplane UXP (Upbound) install error in CI

Universal Crossplane (UXP) is Upbound's distribution of Crossplane, installed with the up CLI or its Helm chart. Installs fail when the up CLI is missing, the chart repository is not added, or the target namespace is wrong.

What this error means

A step running up uxp install fails with "up: command not found", or the UXP Helm install errors on a missing repo or namespace.

up: command not found
# or, via Helm:
Error: INSTALLATION FAILED: repo upbound-stable not found

Common causes

The up CLI or chart repo is not set up

UXP via up needs the up CLI installed; via Helm it needs the upbound-stable repo added first.

Installing into a missing or wrong namespace

The install targets a namespace that does not exist or differs from where later steps expect UXP.

How to fix it

Install the up CLI, then UXP

1. Install the up CLI on the runner.
2. Run up uxp install into the crossplane-system namespace.
3. Wait for the UXP deployment to be ready.

curl -sL https://cli.upbound.io | sh
sudo mv up /usr/local/bin/
up uxp install

Install UXP via Helm with the repo added

Add the Upbound chart repo, then install the universal-crossplane chart into crossplane-system.

helm repo add upbound-stable https://charts.upbound.io/stable
helm repo update
helm install uxp upbound-stable/universal-crossplane \
  -n crossplane-system --create-namespace --wait

How to prevent it

• Install the up CLI (or add the Helm repo) before UXP steps.
• Install UXP into a consistent namespace across the pipeline.
• Wait for the UXP rollout before applying packages.

Related guides