Migrate your Parse App to Back4App

Using our CLI migration tool you will migrate your Parse App to Back4App in minutes. The tool works for self-hosted solutions or Parse Hosting Providers.

Install Node.JS (>= 8.0) and npm

If you don’t have Node.js or npm installed in your machine, please take a look in this link:

GET Node

Install @back4app/m2b4a

npm install -g @back4app/m2b4a

Execute the migrate command

Go to your dumped folder and execute the command below:

migrate-to-back4app

When the migration is finalized, you will receive a confirmation message with all your app credentials, including your new MongoDB database URI.

Connect your current API to your new MongoDB database at Back4App

Now it is time to update your current API to use the new MongoDB database at Back4App so you can make sure that your current users will start reading and writing from/to Back4App. Use the URI that was printed in the end of the last step command execution.

If you are migrating from Buddy, you can use the “Set external URL” option in Buddy Dashboard.

Connect your frontend code to Back4App

Now you need to change your frontend code to connect to Back4App API (https://parseapi.back4app.com) and use your new credentials what were printed in step 4.

Test your app and deploy the new versions to the store

That's the final step and once you have concluded it, your app is safe at Back4App!

Optional: Import your cloud code using our CLI

Important:
  1. TIP: Use our CLI to upload your cloud code: https://www.back4app.com/docs/platform/command-line-interface.
  2. TIP: Use the command 'b4a new' to download the directory structure to paste your cloud code files and 'b4a deploy' to upload them to your app.
  3. Back4App uses 2 main folders: "public/" to public files, like html, css, etc. and "cloud/" to private cloud code.
  4. Inside "cloud/" Back4App import 2 files. One named "app.js" for your custom api (app.get('/my-custom-api') for ex.) and "main.js" for Parse.Cloud functions and jobs.
  5. VERY IMPORTANT! "app" (the express.js instance) and "Parse" variables are global. Don't install them on your package.json or require them in your cloud code (don't use require('express') or require('parse/node'), just use app and Parse variables).

Getting help

If you need any assistance, please open a ticket or schedule an appointment with our engineering team.

SCHEDULE AN APPOINTMENT