Skip to main content

Migrating from Google Container Registry to Artifact Registry

Info:

This only applies to self-managed installations. Txture SaaS instances will be migrated automatically.

Background​

Google is deprecating Container Registry on March 18th, 2025. As a result, we are transitioning to Artifact Registry. This migration requires updating the Txture Image URL in your configuration.

Migration Steps​

  1. Create a backup of your txture installation
  2. Update the Txture image URL in your docker-compose file
  3. Follow the standard upgrade procedure outlined in Upgrading Txture

Image URL Update​

Replace the old image URL with the new one in your docker-compose file:

Previous configuration example:

txture:
  image: "eu.gcr.io/txture-docker/txture:latest"
  container_name: txture

New configuration example:

  txture:
    image: "europe-docker.pkg.dev/txture/production/txture:latest"
    container_name: txture

FAQ​

Will this impact the data of my current installation?​

No, this migration only changes the location from which the Txture image is pulled. Your installation's data remains unaffected.

What happens if I don't migrate?​

After March 18th, 2025, the old Container Registry URL will stop working. Txture uprades will therefore fail.