Back4App

How can I migrate my Parse Server App to Back4App?

Introduction

In this guide, you will learn how to migrate an existing Parse App to Back4App. Before moving your App, you’ll see how to test your Database, files, and cloud functions running on Back4App servers. Once validated, you will be ready to finish the migration and start using Back4App as your Parse provider. If you prefer to migrate using the CLI migration tool, please check this guide.

Goal

Migrate a Parse App to Back4App servers.

Step 1 - Create a New Back4App App

The first step is to create a Back4App App where you will migrate your current App. Check this tutorial to learn how to create one.

Step 2 - Connect Back4App to your current Database

Go to the database section of your current hosting account’s control panel and copy your connection string. Now you’ll use it to connect the Back4App Parse Server with your existing Database.

Open your Back4App Dashboard, go to the Server Settings > Core Settings > Settings and then scroll to the bottom of the page to spot shown in the image:

Owner Account

Next, click on the button Edit details, go to the MongoDB Database URI and click on the change database URI link. By doing so, you will be able to update the connection string with the new copied value.

Step 3 - Upload your Cloud Code

If your App has Cloud Code files, you will need to deploy them on Back4App to ensure that all the files are working correctly.

You can deploy your Cloud Code files in batch using the Back4App CLI (Command Line Interface) tool or manually using the Dashboard under Cloud Code Functions.

After uploading them, you can check the logs available at Server Settings > Logs > Settings > Server System Log.

Step 4 - Migrate your Parse Files

If your App has files(images, documents, videos), you’ll need to migrate them to the Back4App(we are using Amazon AWS S3 as file storage). The process to migrate your files is manual. You should compact all the objects into a zip file or within your S3 bucket and contact us(on [email protected]) to help you deploy them on Back4App servers.

Note: If you have files saved directly on MongoDB please, let us know. The process is different in this case.

If you are using any other file storage solution, it’s required to send a Zip file comprising your files to our team.

Step 5 - Updating your frontend

Now, you need to test if all your App features are working when connected to Back4App servers. Go to your frontend code and update your App keys and server URL of your App. Test all your app features to make sure that the migration has worked. You can now release a new App version to your users.

In this scenario, you will have two versions of your App: a new one with Back4App and the old one that uses your previous Parse hosting.

  • The non-updated users will still be pointing to your “old” API;
  • The updated users will be pointing to Back4app API;

You have to choose the best time to finish the migration and move your Database definitely to Back4App.

Step 6 - To finish the process

It’s time to migrate your Database. We recommend proceeding with this step after making sure most of your users are using your Back4App App version and successfully conclude all the previous migration steps.

Now you can migrate the Database by yourself using the Back4App migration CLI or open a ticket on our support channel, so we can do it for you.

If you decide to open a ticket, please provide your previous Parse hosting connection string and your Back4App App ID.

It’s done!

With the guide described above, you’ll be able to migrate your Parse App to the Back4App and work with our various full-fledged, excellent features!

In case you need any help or a link doesn’t work, please contact our team via chat!