🤖 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.
Migrate
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_dumpcommand, please use the following options:--format=cand--compress 9to 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. |