Updating the application

Use these steps to upgrade a Docker Compose deployment.

Before you upgrade, make sure you have recent backups of your Syntho Postgres database.

There are a couple of steps that can be asked to do from the Syntho Team:

• Upgrading to a newer application version

• Updating the license key

• Updating the Docker registry credentials

Update registry credentials and license key

To pull the latest images, Docker must be authenticated to the Syntho container registry. When credentials expire login with:

docker login <REGISTRY_HOST> -u <USERNAME> -p <PASSWORD>

Syntho may also provide a new license key. Update the license key in your .env file.

LICENSE_KEY=<new-license>

Some older Compose bundles use SYNTHO_LICENSE instead of LICENSE_KEY. Use the variable name that exists in your .env.

After doing this, make sure to restart the application using docker compose up -d.

Update the application version

Most Compose bundles use APPLICATION_VERSION to pin the version:

APPLICATION_VERSION=<new-version>

Some bundles expose separate image variables instead (for example CORE_IMAGE, BACKEND_IMAGE, FRONTEND_IMAGE, RAY_IMAGE). If those exist in your .env, update the tags there.

Then apply the changes:

docker compose pull
docker compose up -d