Skip to main content

Upgrading Txture

In principle the upgrade process is straightforward for the administrator. Make sure you create a backup of your txture_home folder. The upgrade itself is a drop-in replace of the existing installation. Any necessary migrations will be automatically undertaken by Txture. After the upgrade, make sure that you are running the new version by looking either at the version number in the "About" dialog or at the output of the startup process.

Warning:

With the release of Txture 34 the internal configuration database is migrated from SQLite to PostgreSQL 15+. In addition, an upgrade from Tomcat 9 to Tomcat 10.1 is required. If you are not using a SaaS instance, please have a look at the migration guide.

Upgrading Docker deployments

By using volumes to store data, a docker container essentially becomes a throw-away item. One can safely delete a container or image and no data is lost. This makes updating a breeze!

Using docker-compose

If you are using docker-compose you may simply to the following from the directory where your docker-compose.yml is located:

docker-compose down

Modify the docker-compose.yml to include the new version number as the container tag.

docker-compose up -d

Directly run via Docker

First stop the running Txture container and remove it:

docker stop txture
docker rm txture

Note that the second step is actually necessary as docker would complain otherwise when starting a new container with the same name. In the next step, download the new Txture version:

docker pull eu.gcr.io/txture-docker/txture:<new_version>

As a next step, a backup for the folder containing your volume is highly recommended. Although version upgrades are carefully tested, a backup is always recommended. If the container is stopped, you can simply make a copy of the txture_home folder.

After the backup and after downloading the new image, simply start Txture again as before:

docker run --name txture -p 8080:8080 -d -v /path/to/your/txture_home:/opt/txture_home eu.gcr.io/txture-docker/txture:<new_version>