---
title: Upgrading on Docker Compose
url: https://www.tines.com/docs/self-hosted/upgrade-tines/upgrading-on-docker-compose/
updated: 2026-03-18T09:21:52+00:00
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Self-Hosted](https://www.tines.com/llm/docs/self-hosted.md) › [Upgrading Tines](https://www.tines.com/llm/docs/self-hosted/upgrade-tines.md)*

# Upgrading on Docker Compose

*[View on tines.com](https://www.tines.com/docs/self-hosted/upgrade-tines/upgrading-on-docker-compose/)*

> **IMPORTANT:**
> To ensure a smooth upgrade experience and maintain compatibility, we recommend customers follow these sequential upgrade paths:
> 
> For example From version 18.x to 20.x:  
> Upgrade first from 18.x to 19.x.  
> After successfully upgrading to 19.x, proceed to upgrade from 19.x to 20.x.

### Pre-upgrade recommendations

Before upgrading, we advise that you backup your data.

### Step 1. Downloading upgrade package 

You will need to have an active Cloud tenant to access the latest self-hosted version of Tines. Download the Tines installation package using the following link:

https://<your cloud tenant name>.tines.com/admin/upgrade

For example

[https://quiet-sky-3834.tines.com/admin/upgrade](https://quiet-sky-3834.tines.com/admin/upgrade)

The file will be a zip archive named as follows: tines_<build id>.zip. 

Unzip the archive and upload it to the host machine where Tines is installed. 

### Step 2. Move files to the installation directory 

Unzip the installation package and move all the files to the tines installation directory: 

```bash
unzip tines_<build_id>.zip 

cp -rT tines_<build_id>/ /opt/tines  
```

### Step 3. Running upgrade script 

The installation package includes an upgrade script, upgrade.sh. Ensure it is executable with the following command: 

```bash
chmod +x upgrade.sh
```

Run the upgrade script: 

```bash
./upgrade.sh 
```

When the upgrade script runs it will attempt to back up the database. To do this, it will print a list of volumes where the database data may be stored. When prompted, type the correct volume (under default conditions there will only be one). 

 

### Troubleshooting 

If Tines did not start after running ​docker-compose up​, check the console for relevant errors. You can also use steps in our [Troubleshooting Tines on Docker Compose](https://www.tines.com/docs/troubleshooting-tines-on-docker-compose/) to diagnose the issue.

Contact ​**support@tines.io**​ with the output of ​upgrade.sh script and docker-compose logs​.



### Upgrading Redis

Tines 14.0 and above requires Redis 6.2 or above, Tines 31.2 recommends using Redis 7.2 or Valkey 7.2. If you were previously running Tines 13.x or below then you'll need to change the version of the Redis Docker image used in your installation. This can be done at any stage before upgrading to 14.x or above - Redis 6.2 is compatible with all previous Tines versions.

To do this you need to:

1. Open a terminal in your installation directory (typically `/opt/tines`).
2. Run `docker-compose stop` to stop your installation's Docker containers. This will completely stop your installation until you restart the containers later, so be aware that this will cause downtime.
3. Open the `docker-compose.yml` file in your installation directory.
4. `Edit the image` key under the `redis` service in that file to use the image you require, `redis:x.x-alpine`.
5. Save your changes to the `docker-compose.yml` file and run `docker-compose up -d` - this will restart your installation with the new Redis image.