> For the complete documentation index, see [llms.txt](https://docs.elimity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elimity.com/technical-guides/working-with-containers/manual-deployments-with-docker-engine.md).

# Manual deployments with Docker Engine

If using a CaaS solution is not an option, then another alternative we support is a manual deployment with Docker Engine. This page provides some additional guidance on how to install and use Docker Engine and Docker Compose (which we also recommend to simplify container management).

## Installation

### Docker Engine and Docker Compose

The exact steps to install Docker Engine and Docker Compose depend on your host platform:

{% tabs %}
{% tab title="Windows Server" %}

1. Run Microsoft's official PowerShell script to install Docker Engine as explained in [their documentation](https://learn.microsoft.com/en-us/virtualization/windowscontainers/quick-start/set-up-environment?tabs=dockerce#windows-server-2).
2. Install Docker Compose standalone as explained in [the official documentation](https://docs.docker.com/compose/install/standalone/#on-windows-server). Note that you should place the `docker-compose.exe` file next to `docker.exe`, which probably is in `C:\Windows\System32`.
3. Verify that both `docker` and `docker-compose` CLIs are installed correctly.
   {% endtab %}

{% tab title="Linux" %}

1. Follow the steps outlined in [the official installation manual](https://docs.docker.com/engine/install/) to install Docker Engine for your specific OS.
2. Verify that both the `docker` and `docker compose` CLIs are installed correctly.
   {% endtab %}
   {% endtabs %}

### GCR Docker credential helper

As mentioned in [the documentation about our container registry](/technical-guides/working-with-containers/container-registry.md) we host our images in a Google Cloud Artifact Registry at `europe-west1-docker.pkg.dev`. To pull images from this registry, authenticating with a customers.elimity.com account is required. We recommend installing Google's credential helper for Docker to facilitate this process. Refer to [their official documentation](https://cloud.google.com/artifact-registry/docs/docker/authentication#standalone-helper) for detailed instructions. Verify that the `docker-credential-gcr` CLI is installed correctly and listed in your system `PATH`. Now execute the following commands to configure the credential helper:

{% tabs %}
{% tab title="Windows Server" %}

<pre class="language-powershell"><code class="lang-powershell">PS C:\> docker-credential-gcr configure-docker --registries europe-west1-docker.pkg.dev
<strong>PS C:\> docker-credential-gcr gcr-login
</strong></code></pre>

{% endtab %}

{% tab title="Linux" %}

```shell-session
$ sudo docker-credential-gcr configure-docker --registries europe-west1-docker.pkg.dev
$ docker-credential-gcr gcr-login
```

{% endtab %}
{% endtabs %}

You can now test the credential helper by pulling one of our images:

{% tabs %}
{% tab title="Windows Server" %}

<pre class="language-powershell"><code class="lang-powershell"><strong>PS C:\> docker pull europe-west1-docker.pkg.dev/elimity-general/docker/insights:v3.40.0
</strong></code></pre>

{% endtab %}

{% tab title="Linux" %}

```shell-session
$ sudo docker pull europe-west1-docker.pkg.dev/elimity-general/docker/insights:v3.40.0
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.elimity.com/technical-guides/working-with-containers/manual-deployments-with-docker-engine.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.