GitLab container registry 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.

If your organization enabled two-factor authentication (2FA) for your GitLab organization or project, you must use your personal access token as your password when you create your GitLab container registry credentials.

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.

Create a personal access token (PAT)

If your organization enabled 2FA for your organization or project, you must create a PAT to access your GitLab container registry from Wave. For more information, see Create a personal access token. If your organization created a project access token or a group access token, ask your GitLab administrator for access.

Add credentials to Seqera

1. Add your credentials to your organization or personal workspace:

   • From an organization workspace: Go to Credentials > Add Credentials.
   • From your personal workspace: From the user menu, go to Your credentials > Add credentials.

2. Complete the following fields:

   • Name: Specify a unique name for the credentials using alphanumeric characters, dashes, or underscores. For example, my-registry-creds.
   • Provider: Select Container registry.
   • User name: Specify your GitLab username.
   • Password: Specify your personal access token (PAT), group access token, or project access token if 2FA is enabled by your GitLab organization. Otherwise specify your GitLab password.
   • Registry server: Specify your GitLab container registry URL. For example, gitlab.example.com.

3. After you've completed all the form fields, select Add. The new credential is now listed under the Credentials tab.