# Docker Registry settings

> **TL;DR**
> `File | Settings | Build, Execution, Deployment | Docker | Docker Registry` for Windows and Linux
>
>
>
> `IntelliJ IDEA | Settings | Build, Execution, Deployment | Docker | Docker Registry` for macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ![the Settings icon](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.settings.svg)

Specify the settings for accessing the [Docker registry](https://docs.docker.com/registry/) used to store and distribute Docker images.

Procedure: Enable the Docker plugin

This functionality relies on the [Docker](https://plugins.jetbrains.com/plugin/7724-docker)  plugin, which  is bundled and enabled in IntelliJ IDEA   by default. If the relevant features are not available, make sure that you did not disable the plugin.

> **Note:**
> The Docker plugin is available by default only in IntelliJ IDEA  with the Ultimate subscription. For IntelliJ IDEA, you need to install the Docker plugin as described in [Plugins](managing-plugins.html).

1. Press `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) to open settings and then select `Plugins`.

2. Open the Installed tab, find the Docker plugin, and select the checkbox next to the plugin name.

![Docker Registry settings](https://resources.jetbrains.com/help/img/idea/2026.2/docker_registry_settings.png)

By default, IntelliJ IDEA allows you to pull public images from [Docker Hub](https://hub.docker.com/). If you want to use a private repository, add a Docker registry and provide your account credentials.

![the Add button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.add.svg) Add
: Add a new Docker registry.

![the Remove button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.remove.svg) Delete `Alt+Delete` (Windows), `Alt+Delete` (macOS), `Alt+Delete` (IntelliJ IDEA Classic (macOS)), `Alt+Delete` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `Alt+Delete` (Sublime Text (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Visual Studio), `Alt+Delete` (Visual Studio (macOS)), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))
: Remove the selected Docker registry.

For each Docker registry, configure the following:

Name
: Specify the name for this registry configuration.

Registry
: Select one of the available Docker registry types:
:
:
:
:
:
: * Docker Hub: specify your credentials to access private images in the main Docker registry at [registry.hub.docker.com](https://hub.docker.com/). By default, IntelliJ IDEA can access only public images on Docker Hub.
:
: * GitLab: use the main GitLab registry at [gitlab.com](https://gitlab.com/) or specify a self-hosted GitLab registry.
:
: * JetBrains Space: use the Docker registry in your instance of [Space](https://www.jetbrains.com/space/). > **Note:** > Specify the domain address of your Space instance, such as `mycompany.jetbrains.space`.
:
: * Docker V2: specify any registry that supports [Docker Registry HTTP API V2](https://docs.docker.com/registry/spec/api/).
:
: * Generic: If other registry types don't work, add your registry as generic. You will not be able to browse and pull images in the Services tool window, but it will be possible to push images to this registry. For example, IntelliJ IDEA does not fully support the [Quay](https://www.projectquay.io/) image registry, but you can add it as a generic registry: create a repository on [quay.io](https://quay.io/) and specify `quay.io` as the address, your username and password.

Address
: Specify the URL of the Docker registry.

Username
: Specify the name of your user account in the selected registry.

Password
: Specify the password for your user account in the selected registry.

Token
: Specify the access token for the selected Docker registry

## Azure Container Registry

IntelliJ IDEA supports adding an [Azure Container Registry](https://learn.microsoft.com/en-us/azure/container-registry/) as a Docker V2 registry.

If you are using a temporary token for [individual login with Azure AD](https://learn.microsoft.com/en-us/azure/container-registry/container-registry-authentication?tabs=azure-cli#individual-login-with-azure-ad), set the username to `00000000-0000-0000-0000-000000000000` and the password to the token returned by `az acr login` with the `--expose-token` parameter. Use these commands to log in to the Azure CLI and expose the token:

```SHELL
az login
az acr login --name <azureregistryname> --expose-token
```

> **Note:**
> When the temporary token expires, you will need to generate a new one and update it in the registry settings.

If you want to use an [admin user account](https://learn.microsoft.com/en-us/azure/container-registry/container-registry-authentication?tabs=azure-cli#admin-account), enable it in the Azure portal or via the Azure CLI:

```SHELL
az acr update -n <azureregistryname> --admin-enabled true
```

You can set the admin username and password when configuring your Azure Container Registry.

## See also

### Related

[Docker](docker.html)

### Reference

[Docker connection settings](settings-docker.html) [Docker console settings](settings-docker-console.html) [Services tool window](services-tool-window.html)

