🤖 For AI agents: The complete documentation index is available at /docs/llms.txt. A markdown version of this page is available at /docs/cloud/operate/migrate.md.

If you are interested in migrating to FusionAuth from an auth system other than FusionAuth, check out the Migration Guide.

To migrate from a self-hosted instance to FusionAuth Cloud:

  • You must be running PostgreSQL. If you are running MySQL, please migrate to a PostgreSQL database locally. Here's a forum post on how to do this. This has been provided by the community and is not supported nor endorsed by FusionAuth.
  • Export your FusionAuth database to a file. When you run the pg_dump command, please use the following options: --format=c and --compress 9 to minimize the file size.
  • Encrypt the export file with a symmetric solution such as gpg.
  • Purchase a FusionAuth Cloud deployment that meets your needs. Select the version of FusionAuth that is the same as your local installation. You will be able to upgrade FusionAuth later; see Upgrading a Deployment for more.
  • Open a support ticket and provide the database export file, the version of PostgreSQL you are running, and the name of the new FusionAuth deployment.
  • Provide the password for the database export through another channel. You can mention the channel you'd prefer in the support ticket. Slack, email and a separate support ticket are all options.

Within 1-2 business days, we will upload your data to your FusionAuth Cloud deployment.

After your data is uploaded, upgrade your deployment to any subsequent FusionAuth version, if desired. See Upgrading a Deployment for more.

Done?Task
Confirmed running Postgres for local instance.
Found FusionAuth version for local instance.
Created a new deployment. Instructions: Creating a Deployment.
Ensured the FusionAuth Cloud deployment and the local instance are running the same version of FusionAuth.
Communicated the version of Postgres used in the export file.
Encrypted the database export.
Provided the decryption password via a separate communication channel.