# Integration with Docker

If you want to run Docker images from your own registry, for example, to develop and run private applications, you can use the following methods:

#### Local docker images

Put your Docker image on the computer where the agent is running. When the application starts, agent will find this image and run it.

#### User account settings

This method is better for you if you want only specific users to have access to Docker registry credentials.

{% hint style="warning" %}
This method requires instance version \`6.7.41\` or higher
{% endhint %}

Open "Account Settings" -> "Registries" -> click the "Add" button. Fill in the form and click "Add registry".

![](/files/W9eLGdgpM4iOmgqBAlJr)

In order for agent to have access to the registry from your account, go to the "Team Cluster" page -> open agent "Instructions" -> click "Advanced settings" and enable "Add my Docker credentials" setting.

![](/files/40qDYd5lYRfq4W5xqZbC)

Next, redeploy your agent to apply changes. Copy the command and run it on the server where this agent is running.

{% hint style="info" %}
You must be the agent owner that it had access to your registries list.
{% endhint %}

#### Supervisely configuration

This method will allow any agent on your instance to connect to your docker registry (this will require the agent to be redeployed)

1. Connect to the server where Supervisely instance is running. Open `.env` file in Supervisely folder and add your registry credentials to the following fields with a comma separation:

```
DOCKER_REGISTRY=docker.enterprise.supervise.ly,<your-registry-url>
DOCKER_LOGIN=sly...,<your-registry-login>
DOCKER_PASSWORD=va7f...,<your-registry-password>
AGENT_DOCKER_REGISTRY=docker.enterprise.supervise.ly,<your-registry-url>
AGENT_DOCKER_LOGINsly...,<your-registry-login>
AGENT_DOCKER_PASSWORD=va7f...,<your-registry-password>
```

2. Restart your instance

```
sudo supervisely up -d
```

3. Redeploy your agents to apply changes. To do this go to the "Team Cluster" page -> open agent "Instructions" -> Copy the command and run it on the server where this agent is running.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.supervisely.com/agents/custom-docker-registry.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
