Skip to main content

GitLab container registry credentials

GitLab Container Registry credentials allow the Wave container service to authenticate and pull container images from your GitLab repositories. If your organization has enabled two-factor authentication (2FA), you must use a personal access token for GitLab container registry authentication.

note

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.