Skip to main content

Mirror Spaces images

up space mirror copies all OCI artifacts for a given Spaces version to a local directory (as .tar.gz files) or a container registry.

For full usage, flags, and examples, see the up space mirror section of the CLI reference.

Prerequisites​

  • The Up CLI installed
  • An Upbound token file for registry authentication (JSON with accessId and token)
  • The target Spaces version (for example, v1.15.2)

Mirror to a local directory​

To export artifacts as .tar.gz files into a directory:

up space mirror -v <version> --output-dir=<path> --token-file=<path-to-token.json>

Example:

up space mirror -v 1.15.2 --output-dir=/tmp/spaces-artifacts --token-file=upbound-token.json

Mirror to a private registry​

To push artifacts to your own container registry:

  1. Log in to the registry (for example, docker login myregistry.io).
  2. Run the mirror command with --destination-registry:
up space mirror -v <version> --destination-registry=<registry> --token-file=<path-to-token.json>

Example:

up space mirror -v 1.15.2 --destination-registry=myregistry.io --token-file=upbound-token.json
tip

Use --dry-run to list the artifacts that would be mirrored without copying them. This checks proper access to the Upbound registry.