Updating your iTDS Server

# Log in to the registry (credentials in delivery e-mail)
docker login registry.paterva.com

# Stop running containers
docker compose -f itds.yml down

# Replace compose file with latest version and pull new images
curl -o itds.yml "https://dolores.paterva.com/customers/docker/download_compose/12/"
docker compose -f itds.yml pull

# Start the updated stack
docker compose -f itds.yml up -d

# Tail logs until startup completes
docker compose logs -f

# Fix ownership of paired configurations (once stack is healthy)
sudo docker exec -u 0 itds-itdsphp-1 chown -R php:php /usr/local/paired_config

2.3  Docker‑Compose Deployments (offline)

Use a host with Internet connectivity to pull the images, save them to tar files, then copy and load them on the isolated host.

# On connected host
docker login registry.paterva.com

curl -o itds.yml "https://dolores.paterva.com/customers/docker/download_compose/12/"
docker compose -f itds.yml pull

docker save -o itdsapache.tar registry.paterva.com/itdsapache:latest
docker save -o itdsdb.tar     registry.paterva.com/itdsdb:latest
docker save -o itdsphp.tar    registry.paterva.com/itdsphp:latest

# Transfer *.tar files to the offline host and run:
docker load -i itdsapache.tar
docker load -i itdsdb.tar
docker load -i itdsphp.tar

# Proceed with the usual compose-down / compose-up flow (see 2.2)

3.  Updating iTDS to 4.5.x

The iTDS 4.5.x supports SQLite as the default database, so before updating you will need to create a backup of your current server before updating.

Please note that MySQL is considered legacy and user are strongly encouraged to migrate to SQLite.

If you still wish to continue using MySQL, please refer to MySQL legacy support.

The iTDS MySQL to SQLite data migration follows these high-level steps:

1. Create a backup of the existing iTDS
2. Update the existing iTDS
3. Activate license
4. Restore the backup on the new iTDS

3.1 Create a backup of the existing iTDS

(Use the backup guides listed above)

3.2 Update the existing iTDS

Run the Docker commands below as root, either by using sudo, or by running them from a root shell.

Login to Docker registry

docker login registry.paterva.com

Stop your iTDS

docker compose -f itds.yml down

Replace the compose file and pull new images\

curl -o itds.yml "https://dolores.paterva.com/customers/docker/download_compose/12/"

docker compose -f itds.yml pull

Start your updated iTDS

docker compose -f itds.yml up -d

3.3 Activate server

Navigate to https://<server_ip>:8000/itds/activate to access the activation UI.
From the activation page under Upload License Certificate, click Choose File and upload your .pfx license. Click Submit to activate your server.

3.4 Restore the backup on the new iTDS

With the backup file created on the old server, import it onto your new server.

1. On the new server, open the Backup and Restore page in the admin interface (https://<server_ip>:8000/itds/backup).
2. Under Restore Backup, select the ZIP exported from the old server.
3. Click Restore Backup.