Upgrading Quay

Quay Enterprise upgrade guide

This document describes how to upgrade one or more Quay Enterprise containers.

Backup the Quay Enterprise database

The database is the "source of truth" for Quay, and some version upgrades will trigger a schema update and data migration. Such versions are clearly documented in the Quay Enterprise release notes.

Backup the database before upgrading Quay Enterprise. Once the backup completes, use the procedure in this document to stop the running Quay Enterprise container, start the new container, and check the health of the upgraded Quay Enterprise service.

Replace /local/path/to/config/directory and /local/path/to/storage/directory with the absolute paths to those directories on the host. Replace RELEASE_VERSION with the desired Quay Enterprise version.

Rarely, but occasionally, the new Quay Enterprise version may perform a database schema upgrade and migration. Versions requiring such database migrations will take potentially much longer to start the first time. These versions are clearly documented in the release notes, which should be consulted before each Quay Enterprise upgrade.

Check the health of the upgraded container

Visit the /health/endtoend endpoint on the registry hostname and verify that the code is 200 and is_testing is false.

Upgrade the rest of the containers in the cluster.

If the upgraded container is healthy, repeat this process for all remaining Quay Enterprise containers.