Service Migration

Quollix automatically runs selected service migrations during app updates from the App Store. For example, updating Postgres to a new major version no longer requires administrators to run the migration commands by hand. The same service migration mechanism is also used when an administrator directly uploads an app version to Quollix.

Current Support

Quollix currently handles these service migrations:

ServiceMigration behavior
PostgresOn major version changes, Quollix exports a dump with pg_dumpall in the old container and imports it with psql in the new container.
Zulip PostgresZulip’s zulip/zulip-postgresql image follows the same Postgres migration flow.
RabbitMQOn RabbitMQ image version changes, Quollix starts the old RabbitMQ container and runs rabbitmqctl enable_feature_flag all before the update continues.

RabbitMQ

For RabbitMQ, app definitions should keep the RabbitMQ node name stable across container recreations and upgrades, for example by setting RABBITMQ_NODENAME.

MariaDB

Maintainers of apps containing MariaDB services can use MariaDB’s built-in automatic upgrade handling:

environment:
  MARIADB_AUTO_UPGRADE: "1"

Other services

App maintainers should publish app versions that follow each service’s official upgrade path. For these services, no additional manual migration steps are expected:

  • Redis
  • Valkey
Last modified August 21, 2026: optimize high level sections (1fd084a)