HUB (Docker Hub incl private repositories)

logo

The hub registry lets you configure Docker Hub integration.

Currently, the supported credentials are:

Docker Hub auth + Docker Hub Access Token
Docker Base64 credentials (like in .docker/config.json)
Docker Hub auth + Docker Hub password (not recommended)

By default, if you don't configure any registries, drydock will configure a default one with anonymous access. Don't forget to configure authentication if you're using Docker Hub Private Repositories.

Variables

Env var	Required	Description	Supported values
`DD_REGISTRY_HUB_{REGISTRY_NAME}_LOGIN`	⚪	A valid Docker Hub Login	Required with `PASSWORD` or `TOKEN`
`DD_REGISTRY_HUB_{REGISTRY_NAME}_PASSWORD`	⚪	A valid Docker Hub password or access token	`DD_REGISTRY_HUB_{REGISTRY_NAME}_LOGIN` must be defined
`DD_REGISTRY_HUB_{REGISTRY_NAME}_TOKEN`	⚪	A valid Docker Hub access token (alternative to `PASSWORD`)	`DD_REGISTRY_HUB_{REGISTRY_NAME}_LOGIN` must be defined
`DD_REGISTRY_HUB_{REGISTRY_NAME}_AUTH`	⚪	A valid Docker Hub Base64 Auth String	Cannot be combined with `LOGIN`/`PASSWORD`/`TOKEN`

Registry auth now fails closed for invalid combinations. LOGIN must be paired with PASSWORD (or TOKEN alias), and AUTH cannot be combined with LOGIN/PASSWORD/TOKEN.

Examples

Configure Authentication using Login/Token

2. Go to your Security Settings

Create a new Access Token
Copy it and use it as the DD_REGISTRY_HUB_PUBLIC_TOKEN value

Configure Authentication using Base64 encoded credentials

1. Create an Access Token

See above

2. Encode with Base64

Concatenate $auth:$password and encode with Base64.

For example,

if your auth is johndoe
and your password is 2c1bd872-efb6-4f3a-81aa-724518a0a592
the resulting encoded string would be am9obmRvZToyYzFiZDg3Mi1lZmI2LTRmM2EtODFhYS03MjQ1MThhMGE1OTI=

services:
  drydock:
    image: codeswhat/drydock
    ...
    environment:
      - DD_REGISTRY_HUB_PUBLIC_AUTH=am9obmRvZToyYzFiZDg3Mi1lZmI2LTRmM2EtODFhYS03MjQ1MThhMGE1OTI=

docker run \
  -e DD_REGISTRY_HUB_PUBLIC_AUTH="am9obmRvZToyYzFiZDg3Mi1lZmI2LTRmM2EtODFhYS03MjQ1MThhMGE1OTI="
  ...
  codeswhat/drydock

HUB (Docker Hub incl private repositories)

On this page