Upgrade

Before the upgrade

1. Read the release changes.
2. Record the current commit or tag.
3. Back up the database and uploaded files.
4. Test the restore process.
5. Schedule an acceptable service window.

Apply the version

git pull
docker compose -f deploy/docker-compose.yml up -d --build

In image mode, change CIELE_IMAGE_TAG in deploy/.env to the new release and apply it instead:

docker compose up -d

On Ciele Desktop, updating the application performs this step: each build pins the images matching its own version.

The migrate service applies only pending migrations. Inspect its result before you accept the application as healthy.

With an external database, the same command applies the pending migrations to your managed Postgres. The provision service runs first and confirms the roles and schemas. Take a provider snapshot before the upgrade.

docker compose -f deploy/docker-compose.yml ps
docker compose -f deploy/docker-compose.yml logs migrate
docker compose -f deploy/docker-compose.yml logs app

Verify the result

1. Sign in to the administrator console.
2. Open one Assistant.
3. Test Preview.
4. Open one published widget.
5. Call GET /api/v1/meta when programmatic clients are in use.

Do not restore an old application image against an incompatible migrated database. Use the release instructions for a supported rollback path.