Create a private Docker container registry using the Azure portal

Use the Azure portal to create a container registry and manage its settings. You can also create and manage container registries using the Azure CLI 2.0 commands, Azure PowerShell or programmatically with the Container Registry REST API.

For background and concepts, see the overview.

Create a container registry

  1. In the Azure portal, click + New.
  2. Search the marketplace for Azure container registry.
  3. Select Azure Container Registry, with publisher Microsoft. Container Registry service in Azure Marketplace
  4. Click Create. The Azure Container Registry blade appears.

    Container registry settings

  5. In the Azure Container Registry blade, enter the following information. Click Create when you are done.

    a. Registry name: A globally unique top-level domain name for your specific registry. In this example, the registry name is myRegistry01, but substitute a unique name of your own. The name can contain only letters and numbers.

    b. Resource group: Select an existing resource group or type the name for a new one.

    c. Location: Select an Azure datacenter location where the service is available, such as South Central US.

    d. Admin user: If you want, enable an admin user to access the registry. You can change this setting after creating the registry.


    In addition to providing access through an admin user account, container registries support authentication backed by Azure Active Directory service principals. For more information and considerations, see Authenticate with a container registry.

    e. Storage account: Use the default setting to create a storage account, or select an existing storage account in the same location. Currently Premium Storage is not supported.

Manage registry settings

After creating the registry, find the registry settings by starting at the Container Registries blade in the portal. For example, you might need the settings to log in to your registry, or you might want to enable or disable the admin user.

  1. On the Container Registries blade, click the name of your registry.

    Container registry blade

  2. To manage access settings, click Access key.

    Container registry access

  3. Note the following settings:

    • Login server - The fully qualified name you use to log in to the registry. In this example, it is
    • Admin user - Toggle to enable or disable the registry's admin user account.
    • Username and Password - The credentials of the admin user account (if enabled) you can use to log in to the registry. You can optionally regenerate the passwords. Two passwords are created so that you can maintain connections to the registry by using one password while you regenerate the other password. To authenticate with a service principal instead, see Authenticate with a private Docker container registry.

Next steps