Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
registry_url | string | required | Registry URL (e.g., docker://ghcr.io/org/image) |
username | string | required | Registry username |
token | string | required | Personal Access Token |
URL Parsing
| Input | Registry |
|---|---|
docker://ghcr.io/org/image | ghcr.io |
oci://registry.gitlab.com/org/image | registry.gitlab.com |
alpine or library/alpine | docker.io (implicit) |
Examples
Docker Hub:Response
Success: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_imagecall - Expired tokens are automatically removed from cache
Workflow
- Call
registry_token_obtain→ opens browser - User creates read-only PAT in registry web UI
- User provides username and token
- Call
registry_auth→ validates and stores credentials - Call
import_imageto import images