Docker Hub credentials
From version 22.3, Seqera Platform supports the configuration of credentials for the Nextflow Wave container service to authenticate to private and public container registries. For more information on Wave containers, see the Nextflow documentation.
Container registry credentials are only used by the Wave container service. Add wave { enabled=true } to the Nextflow config field on the launch page, or to your nextflow.config file, for your pipeline execution to use Wave containers.
Docker Hub registry access#
You must use Docker Hub credentials with Read-only access to authenticate Seqera to your registry. Docker Hub uses personal access tokens (PATs) for authentication. We don't currently support Docker Hub authentication with 2FA (two-factor authentication).
Create a Docker Hub PAT
- Log in to Docker Hub.
- Select your username in the top right corner and select Account Settings.
- Select Security > New Access Token.
- Enter a token description and select Read-only from the Access permissions drop-down menu, then select Generate.
- Copy and save the generated access token (this is only displayed once).
Add credentials to Seqera#
- From an organization workspace: Go to Credentials > Add Credentials.
- From your personal workspace: From the user menu, go to Your credentials > Add credentials.
| Property | Description | Example |
|---|---|---|
| Name | A unique name for the credentials using alphanumeric characters, dashes, or underscores | my-registry-creds |
| Provider | Credential type | Container registry |
| User name | Your Docker username | user1 |
| Password | Your personal access token | 1fcd02dc-...215bc3f3 |
| Registry server | The container registry hostname (excluding protocol) | docker.io |
When you've completed all the form fields, select Add. The new credential is now listed under the Credentials tab.