anchorectl registry

Registry credential operations.

Every command on this page also accepts the global flags.

Subcommands

  • registry add — Adds a new registry to the system
  • registry delete — Delete a registry configuration record from the system. Does not remove any images.
  • registry get — Get information on a specific registry
  • registry list — List all configured registries the system can/will watch
  • registry update — Replaces an existing registry record with the given record

registry add

Adds a new registry to the system.

anchorectl registry add REGISTRY [flags]

Arguments

ArgumentDescription
REGISTRYHostname:port string for accessing the registry, as would be used in a docker pull operation. May include some or all of a repository and wildcards (e.g. docker.io/library/* or gcr.io/myproject/myrepository).

Examples

# The password is read from the environment, never passed as a flag
ANCHORECTL_REGISTRY_PASSWORD=<REGISTRY_PASSWORD> anchorectl registry add registry.example.com \
  --username ci-runner

# Verify the credential when the registry is added. If the registry cannot be
# reached with these credentials, the command exits 1 and no record is created
ANCHORECTL_REGISTRY_PASSWORD=<REGISTRY_PASSWORD> anchorectl registry add registry.example.com \
  --username ci-runner --validate

Flags

FlagTypeEnvironment variableDefaultRequiredDescription
--usernamestringANCHORECTL_REGISTRY_USERNAME""YesUsername portion of credential to use for this registry.
--namestringANCHORECTL_REGISTRY_NAME""NoHuman readable name associated with registry record.
-o, --outputstringANCHORECTL_FORMATtextNoThe format to show the results. Allowable values: text, json, json-raw, id. See Output Formats.
--secure-connectionboolANCHORECTL_REGISTRY_SECURE_CONNECTIONtrueNoUse TLS/SSL verification for the registry URL.
--typestringANCHORECTL_REGISTRY_TYPEdocker_v2NoType of registry.
--validateboolANCHORECTL_REGISTRY_VALIDATEtrueNoWhether or not to validate registry/credential at registry add time.

registry delete

Delete a registry configuration record from the system. Does not remove any images.

anchorectl registry delete REGISTRY [flags]

Aliases: del

Arguments

ArgumentDescription
REGISTRYThe registry name.

Flags

FlagTypeEnvironment variableDefaultRequiredDescription
-o, --outputstringANCHORECTL_FORMATtextNoThe format to show the results. Allowable values: text, json, json-raw, id. See Output Formats.

registry get

Get information on a specific registry.

anchorectl registry get REGISTRY [flags]

Arguments

ArgumentDescription
REGISTRYRegistry name.

Flags

FlagTypeEnvironment variableDefaultRequiredDescription
-o, --outputstringANCHORECTL_FORMATtextNoThe format to show the results. Allowable values: text, json, json-raw, id. See Output Formats.

registry list

List all configured registries the system can/will watch.

anchorectl registry list [flags]

Flags

FlagTypeEnvironment variableDefaultRequiredDescription
-o, --outputstringANCHORECTL_FORMATtextNoThe format to show the results. Allowable values: text, json, json-raw, id. See Output Formats.

registry update

Replaces an existing registry record with the given record.

anchorectl registry update REGISTRY [flags]

Arguments

ArgumentDescription
REGISTRYThe registry name.

Flags

FlagTypeEnvironment variableDefaultRequiredDescription
--namestringANCHORECTL_REGISTRY_NAME""NoHuman readable name associated with registry record.
-o, --outputstringANCHORECTL_FORMATtextNoThe format to show the results. Allowable values: text, json, json-raw, id. See Output Formats.
--secure-connectionboolANCHORECTL_REGISTRY_SECURE_CONNECTIONfalseNoUse TLS/SSL verification for the registry URL.
--typestringANCHORECTL_REGISTRY_TYPE""NoType of registry.
--usernamestringANCHORECTL_REGISTRY_USERNAME""NoUsername portion of credential to use for this registry.
--validateboolANCHORECTL_REGISTRY_VALIDATEtrueNoWhether or not to validate registry/credential at registry update time.
Last modified September 22, 2026