---
title: "Upgrading CTERA Content Services"
slug: "upgrading-ctera-content-services"
tags: ["Content Services"]
updated: 2026-03-31T04:54:44Z
published: 2026-03-31T04:54:44Z
canonical: "kb.ctera.com/upgrading-ctera-content-services"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.ctera.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrading CTERA Content Services

The procedure to upgrade an existing CTERA Content Services installation is the same for all platforms and **requires** the following:

- Internet access.  

New releases include upgrades to the docker images used by CTERA Content Services.
- Ports  

Make sure that the required ports are open, as described in [Inbound Port Requirements](/v1/docs//technical-specification#inbound-ports) and [Outbound Port Requirements](/v1/docs//technical-specification#outbound-ports).

CTERA Content Services VM can be configured as:

- The default, deployment with both the control plane, the ingestor, and the data plane, the collector end embedding model, deployed on the same VM.
- A separate Ingestor VM and Collector and Embedding model VM.

The upgrade required depends on the configuration.

**To upgrade CTERA Content Services when all the components run on the same VM:**

1. Contact [CTERA Support](https://www.ctera.com/support/) to get the latest CTERA Content Services zip file.
2. Upload the zip file to the CTERA Content Services VM:
  1. For ESXi deployments, upload the zip file to the `/data` directory.
  2. For all other platforms, upload the zip file to the `/home/usr` directory.
3. Enter into the new version directory and unzip the zip file
4. In the unzipped directory, the directory for the new version, run the following command: `docker compose pull`
5. Wait for all the images to download.
6. Go to the old version directory and run the following command: `docker compose down`
7. Go to the new version directory and run the following command: `docker compose -f docker-compose.yaml -f docker-compose.gpu.yaml up -d`
8. Restart the CTERA Content Services VM.

**To upgrade CTERA Content Services when the components run on separate VMs:**

1. Upload the zip file to the CTERA Content Services VM:
  1. For ESXi deployments, upload the zip file to the `/data` directory.
  2. For all other platforms, upload the zip file to the `/home/usr` directory.
2. Enter into the new version directory and unzip the zip file
3. In the unzipped directory, the directory for the new version, run the following command: `docker compose pull`
4. Wait for all the images to download.
5. Go to the old version directory and run the following command: `docker compose down`
6. Go to the new version directory and run the following command: `docker compose -f docker-compose.yaml up -d`
7. Restart the CTERA Content Services VM.
8. Upload the zip file to the Collector VM:
  1. For ESXi deployments, upload the zip file to the `/data` directory.
  2. For all other platforms, upload the zip file to the `/home/usr` directory.
9. Enter into the new version directory and unzip the zip file
10. In the unzipped directory, the directory for the new version, run the following command: `docker compose pull`
11. Wait for all the images to download.
12. Go to the old version directory and run the following command: `docker compose down`
13. Go to the new version directory and run the following command: `docker compose -f docker-compose.gpu.yaml up -d`
14. Restart the Collector VM.