Registry

up registry

Manage registries

Synopsis

Register container registries that up pulls base images from and pushes build output to.

Each registry has a name used by services (source.registry and build.output_registry refer to it by name, not ID). Exactly one registry is the default push target. Adding a registry runs a reachability, auth, and push check unless –no-verify is set.

Run up registry with no subcommand to list registries.

up registry [flags]

Options inherited from parent commands

  -o, --output string   output format: table, json, yaml (list commands only) (default "table")
  -q, --quiet           suppress output
  -v, --verbose count   enable debug output (-v debug, -vv trace)

up registry add

Add a container registry

Synopsis

Register a registry by host (for example ghcr.io), with a username and password. The password may be a literal or a $VAR reference resolved at apply time. Mark it the default push target with –default.

Before adding, up verifies the registry is reachable, the credentials work, and the push permission is granted. Skip that with –no-verify.

Omit the host to be prompted interactively.

up registry add <host> [flags]

Examples

  # Add GitHub Container Registry as the default
  up registry add ghcr.io --username deploy-bot --password $GHCR_TOKEN --default

  # Add without verifying reachability
  up registry add registry.example.com --no-verify

Options

      --default           mark as the default registry
  -n, --name string       display name (defaults to host)
      --no-verify         skip the reachability/auth/push check before adding
  -p, --password string   registry password (prompted if omitted)
  -u, --username string   registry username

up registry list

List registries

Synopsis

List the registered registries as a table, including which one is the default. This is the default action when up registry is run with no subcommand.

up registry list [flags]

up registry remove

Remove a registry (–force also detaches referencing services)

Synopsis

Remove a registry. A registry that is still referenced by a service cannot be removed without –force, which detaches the name references from those services first.

Pass the name, or omit it to pick from a list.

up registry remove <name> [flags]

Examples

  # Remove a registry and detach services that reference it
  up registry remove old-registry --force

Options

      --force   skip confirmation and force removal

up registry set-default

Set the default registry

Synopsis

Choose which registry build output is pushed to by default. Pass the name, or omit it to pick from a list.

up registry set-default <name> [flags]

Examples

  # Make ghcr the default push target
  up registry set-default ghcr