Skip to content
Init is here / May 19 - 23
Back

Upgrade from 1.6.2 to 1.7.2 error during migration

  • 0
  • Self Hosted
  • Tools
  • General
  • Databases
kathelia.dokgu
21 May, 2025, 17:57

I just went through the process of upgrading my selfhosted instance from 1.6.2 to 1.7.2:

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

cd appwrite/
docker compose exec appwrite migrate

During the migration, I saw 4 documents that failed because of a missing attribute: region.

TypeScript
Migrating documents
Migrating documents for collection "projects"
...
Failed to update document "64faa5fe57e2f4380270" in collection "rules":Invalid document structure: Missing required attribute "region"
Failed to update document "64faa6034313f89b1759" in collection "rules":Invalid document structure: Missing required attribute "region"
Failed to update document "64faa60343a95efc831e" in collection "rules":Invalid document structure: Missing required attribute "region"
Failed to update document "67785759bac83b2393c6" in collection "rules":Invalid document structure: Missing required attribute "region"
Migrating documents for collection "installations"
...
Cleaning up collections
Cleaning up collection "projects"
...
Migration completed

The containers seem to be up and running but when I try to access the console, it's stuck at loading and never loads the page. Also, I have monitoring services that checks if my domain name is reachable, and it's reporting as offline now.

TL;DR
Developers encountered an error during migration from version 1.6.2 to 1.7.2, with missing attribute "region" causing document migration failures. The console is inaccessible post-upgrade, and monitoring services indicate the domain is offline. Solution: Check and ensure the necessary "region" attribute is added to documents in the mentioned collections before running the migration. Review logs to address any additional issues that may be affecting accessibility and uptime after the upgrade.
Reply

Reply to this thread by joining our Discord

Reply on Discord

Need support?

Join our Discord

Get community support by joining our Discord server.

Join Discord

Get premium support

Join Appwrite Pro and get email support from our team.

Learn more