Skip to main content
Authenticate with a container registry via Personal Access Token.

Parameters

URL Parsing

Examples

Docker Hub:
GitHub Container Registry:

Response

Success:
Invalid credentials:

Token Storage

  • Credentials are validated via OCI /v2/ API before storage
  • Stored in local cache and persisted across sessions
  • Tokens are revalidated before each import_image call
  • Expired tokens are automatically removed from cache

Workflow

  1. Call registry_token_obtain → opens browser
  2. User creates read-only PAT in registry web UI
  3. User provides username and token
  4. Call registry_auth → validates and stores credentials
  5. Call import_image to import images