What is new in Appwrite 1.9.6 for self-hosted deployments?

Appwrite 1.9.6 fixes the upgrade and migration issues reported after 1.9.5. It repairs missing Git provider attributes on Functions and Sites automatically, makes migrations idempotent, fixes container and MongoDB healthchecks, and gives the installer more time to pull images and start services.

Do I need to upgrade from 1.9.5 to 1.9.6?

If you hit migration errors or healthcheck failures while upgrading to 1.9.5, yes. 1.9.6 resolves those issues and repairs affected Functions and Sites automatically during migration.

How do I upgrade my self-hosted instance to 1.9.6?

Back up your data, pull the 1.9.6 image, run the upgrade command, and then run the migration. See the [upgrade guide](/docs/advanced/self-hosting/production/updates) for the full steps.

Does Appwrite 1.9.6 change any APIs?

No. 1.9.6 is a patch release on top of 1.9.5 with the same API surface, so no changes to your application code or SDKs are required.

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:

Bash

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:

Shell

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.

Bash

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.