Docs

Upgrade

To upgrade your Appwrite server from an older version, you should use the Appwrite migration tool after you have installed the new version. The migration tool will adjust your Appwrite data to the new version's structure to make sure your Appwrite data is compatible with any internal changes.

A Note About Migration

At present, we support migrations only to the immediately higher versions, i.e from 0.6 to 0.7 and 0.7 to 0.8 and so on. So if you're trying to migrate from 0.6 to 0.8, you will first need to migrate to 0.7 and then to 0.8

It is highly recommended to backup your server data and your docker-compose.yml file settings before running the migration tool. It is recommended to run the migration process on a dev instance and make sure your application is working well and that you have checked for any breaking changes in the new version changelog.

The first step is to install the latest version of Appwrite. Head to the directory where you first installed Appwrite. This is where you will find the appwrite directory and the appwrite/docker-compose.yml file. Make sure you are at the same level as the appwrite directory and then execute the following command

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

This will pull the docker-compose.yml file for the new version and perform the installation. Once the setup completes, verify that you have the latest version of Appwrite.

docker ps | grep appwrite/appwrite

Verify that the STATUS doesn't have any errors and all the appwrite/appwrite containers have version : 0.9.2

We can now start the migration. Navigate to the appwrite directory where your docker-compose.yml is present and run the following command

cd appwrite/
docker-compose exec appwrite migrate

Once the migration process has completed successfully, you're all set to use the latest version of Appwrite!