Announcing Appwrite 1.9.6 for self-hosted deployments_

Appwrite 1.9.6 is now available for self-hosted deployments.

After the 1.9.5 release, many of you reported issues while upgrading, most of them related to migrations. Appwrite 1.9.6 fixes those issues.

Here is what changed.

Migration fixes

The migration to 1.9.5 could fail or leave instances in an inconsistent state in a few scenarios. 1.9.6 addresses them:

• Missing providerBranches and providerPaths attributes on Functions and Sites are now repaired automatically during migration. Operators no longer need to apply metadata and table changes manually.
• Migrations are now idempotent. Attribute batches skip attributes that already exist, and the V25 migration skips collections that are absent, so re-running a migration after a partial failure works as expected.

Healthcheck and installer reliability

• The Appwrite container healthcheck now uses the public version endpoint instead of a side-effecting call.
• MongoDB is only marked healthy once a writable replica-set primary is available, which prevents services from starting against a database that is not ready.
• The doctor task now reports database and queue connectivity correctly.
• The installer allows more time to pull images and start Compose services, which fixes timeouts on slower connections.

Service updates

This release also updates the bundled services: the self-hosted Console moves to 8.7.30, the Open Runtimes Executor to 0.25.4, and the Browser service to 0.3.3.

Upgrade your self-hosted instance

Back up your data first, then run the upgrade command:

docker run -it --rm \
    --publish 20080:20080 \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="upgrade" \
    appwrite/appwrite:1.9.6

After the upgrade is complete, run the migration:

cd appwrite/
docker compose exec appwrite migrate

For the full walkthrough, see the upgrade guide.

Self-host Appwrite 1.9.6

If you are setting up Appwrite for the first time, all you need is Docker installed. Run the installer with the 1.9.6 image, then open http://localhost:20080 to complete the setup wizard.

docker run -it --rm \
    --publish 20080:20080 \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="install" \
    appwrite/appwrite:1.9.6

For system requirements and the full walkthrough, see the installation guide.

More resources