Skip to content
Back

[BUG] The cloud cannot be migrated to self-hosting.

  • 0
  • 2
  • Self Hosted
  • Cloud
Bret
2 Jan, 2026, 20:27

The cloud cannot be migrated to self-hosting.

The content of this post is exactly the same as issue 11068

I reproduced this error.

Steps to reproduce:

  • Install self-hosted Appwrite 1.8.1 (or 1.8.0).
  • Go to your cloud project.
  • Click "Settings" > "Migration" > "Export to self-hosted instance".
  • Set the "Endpoint Self-Hosted Instance URL".
  • You will be redirected to a new page, and set a new name for the new project you want to create.
  • Click "Next": An error occurs: "Invalid region parameter: Value must be one of the following (default value)".

The migration failed immediately with the following error: "Invalid region parameter: Value must be one of (default)".

When the error occurred, the Appwrite container logged the following: appwrite | [Error] Method: POST appwrite | [Error] URL: /v1/projects appwrite | [Error] Type: Utopia\Exception appwrite | [Error] Message: Invalid region param: Value must be one of (default) appwrite | [Error] File: /usr/src/code/vendor/utopia-php/framework/src/App.php appwrite | [Error] Line: 910

For the migration of existing projects, the following will be displayed:

Couldn’t load resources The API key required for the migration may no longer be valid or has expired, please verify and start migration again.

I think Appwrite Cloud submitted its own region information, but the self-hosted version only recognizes the default region.

TL;DR
Issue with migrating cloud to self-hosting, receiving errors related to region parameters. User experiencing difficulty creating a project due to region validation errors. API key is valid. Discrepancy in console versions may be the cause, as newer version may be required. Solution may involve updating console version to match Appwrite version. Region error is actually the cause of the problem, despite UI error message.
2 Jan, 2026, 23:18

what's the URL you end up on?

2 Jan, 2026, 23:27

redact some values

2 Jan, 2026, 23:28

what your mean?

2 Jan, 2026, 23:29

the url had an api key in it

2 Jan, 2026, 23:32

non-decode URL

2 Jan, 2026, 23:34

so i tried to reproduce, but it worked okay for me

2 Jan, 2026, 23:37

The migration wizard creates a project the same way as the create project modal.

2 Jan, 2026, 23:44

Mine still doesn't work. Creating a new project shows "Invalid region param: Value must be one of (default)," and existing projects show "Couldn’t load resources. The API key required for the migration may no longer be valid or has expired, please verify and start migration again." (Even though I manually created an API key.)

2 Jan, 2026, 23:45

what console version do you have?

2 Jan, 2026, 23:45

what is the API call made?

2 Jan, 2026, 23:45

For appwrite is 1.8.1

2 Jan, 2026, 23:46

no in your docker-compose.yml, what is the version of the console service

2 Jan, 2026, 23:46

Let me see really quick

2 Jan, 2026, 23:47

7.5.7

2 Jan, 2026, 23:48

oh weird..mine is 6.0.13

2 Jan, 2026, 23:49

mine is outdated

2 Jan, 2026, 23:50

nonetheless, can you share the details of the create project api call?

2 Jan, 2026, 23:52

Yes

2 Jan, 2026, 23:56

Okay…

2 Jan, 2026, 23:57

body:

TypeScript
{"projectId":"69585af0000ad48849cf","name":"T","teamId":"695439a7001bd264f1d4","region":"fra"}
TypeScript
{
    "message": "Invalid `region` param: Value must be one of (default)",
    "code": 400,
    "type": "general_argument_invalid",
    "version": "1.8.1"
}
3 Jan, 2026, 00:01

The UI says "Couldn't load resources. The API key required for the migration may no longer be valid or has expired. Please verify and start migration again." However, it's actually still a region error.

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