---
title: Install With Sitecore in Docker
slug: lb8f0136
canonical_url: https://docs.coveo.com/en/lb8f0136/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Install With Sitecore in Docker
> **Warning**
>
> The compatibility of Coveo for Sitecore Docker modules with Sitecore on Docker depends on [Sitecore's full Docker support for the given Sitecore release](https://support.sitecore.com/kb?id=kb_article_view&sysparm_article=KB0161310).
> Coveo doesn't offer support for issues with the installation of Coveo for Sitecore in Docker.
> Once Coveo for Sitecore is installed correctly, Coveo can fix client issues as it does with non-Docker setups.

Coveo has contributed to the [Sitecore Docker Images repository](https://github.com/Sitecore/docker-images) to help Sitecore Docker users build Coveo for Sitecore and Coveo for Sitecore SXA Docker images to go along with Sitecore images.
Coveo will not commit to contributing to the Sitecore repository any further.

Once all [images are built](#step-1-build-coveo-for-sitecore-images), you can [launch Sitecore Docker instances](#step-2-launch-sitecore-docker-instances-with-coveo-for-sitecore-pre-installed) with Coveo for Sitecore pre-installed.

This article provides the recommended procedure to install, activate, configure, and scale Coveo for Sitecore in a Sitecore Docker environment.

## Recommended Coveo for Sitecore Version

Coveo for Sitecore and Coveo for Sitecore SXA Docker modules can be generated since [version 5.0.1039.1](https://docs.coveo.com/en/l6h90340/).
However, we recommend you use the latest Coveo for Sitecore release.
Consult the Coveo for Sitecore [Releases and Downloads](https://docs.coveo.com/en/2274/) page to retrieve the latest release build number, as you'll need it in the [installation instructions section](#installation-instructions).

## Installation Instructions

### Step 1: Build Coveo for Sitecore Images

Coveo doesn't add any images directly in the [Sitecore Docker Images repository](https://github.com/Sitecore/docker-images).
Instead, Coveo for Sitecore images are built when calling the repository `Build.ps1` script locally with Coveo-specific parameters.
See [building custom images instructions](https://github.com/Sitecore/docker-images/blob/master/build/INSTRUCTIONS.md) for more details.

**Example**

After running `Build.ps1` with both the Coveo for Sitecore and Coveo for Sitecore SXA related tags, you'll see changes such as the following in your local branch.

![Changes to the repository contents after running build.ps1 command](https://docs.coveo.com/en/assets/images/c4sc-v5/c4sc-docker-changes-after-running-build-ps1-locally.png)

### Step 2: Launch Sitecore Docker Instances With Coveo for Sitecore Pre-Installed

Update the container development Docker files in the [Sitecore Docker Examples repository](https://github.com/Sitecore/docker-examples/tree/develop/custom-images) to bundle Coveo with Sitecore in your preferred Sitecore topology instances.
For example, you can use the [docker-compose.xp1.yml](https://github.com/Sitecore/docker-examples/blob/develop/custom-images/docker-compose.xp1.yml) file as the starting point to launch a Sitecore XP1 topology that includes Coveo for Sitecore.
See the [Sitecore Docker Examples repository documentation](https://github.com/Sitecore/docker-examples/blob/develop/README.md) for guidance.

### Step 3: Configure and Activate Coveo for Sitecore

[Configure and activate Coveo for Sitecore](https://docs.coveo.com/en/3152/) to link your Sitecore CM instance in Docker to a [Coveo organization](https://docs.coveo.com/en/185/).
In this step, you also configure [indexing](https://docs.coveo.com/en/204/) settings.

> **Important**
>
> To unify resources under a single label, set a [farm name](https://docs.coveo.com/en/2149/).
> This is especially important in scaled Sitecore environments.

### Step 4: Scale Coveo for Sitecore

Configuring and activating Coveo for Sitecore on the CM instance in [step 3](#step-3-configure-and-activate-coveo-for-sitecore) populated settings in your CM Coveo configuration files.
To [scale Coveo for Sitecore](https://docs.coveo.com/en/2264/), you should create a [volume](https://github.com/coveooss/sitecore-docker-examples/blob/develop/custom-images/docker-compose.xm1.override.yml#L90-L91) to share the configurations between your CM and CD containers.