1
0
mirror of synced 2025-12-20 18:36:31 -05:00
Files
docs/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md
2021-08-11 11:46:35 -04:00

2.0 KiB

title, intro, versions, topics, product, shortTitle
title intro versions topics product shortTitle
Allowing your codespace to access a private image registry You can use secrets to allow {% data variables.product.prodname_codespaces %} to access a private image registry
fpt
*
Codespaces
{% data reusables.gated-features.codespaces %} Private image registry

A registry is a secure space for storing and managing private container images, such as Azure Container Registry or DockerHub. You can create secrets in GitHub to store the access details for a private registry and use them to give your codespace access to images stored in the registry.

When you launch a codespace, {% data variables.product.prodname_codespaces %} checks for three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_codespaces %} will make the registry available inside your codespace.

  • <*>_CONTAINER_REGISTRY_SERVER
  • <*>_CONTAINER_REGISTRY_USER
  • <*>_CONTAINER_REGISTRY_PASSWORD

You can store secrets at the user, repository, or organization-level, allowing you to share them securely between different codespaces. When you create a set of secrets for a private image registry, you need to replace the “<*>” in the name with a consistent identifier. For more information, see "Managing encrypted secrets for your codespaces" and "Managing encrypted secrets for your repository and organization for Codespaces."

For example, if you had a private image registry in Azure, you could create the following secrets:

ACR_CONTAINER_REGISTRY_SERVER = mycompany.azurecr.io
ACR_CONTAINER_REGISTRY_USER = acr-user-here
ACR_CONTAINER_REGISTRY_PASSWORD = <PAT>

Image registry secret example