Command-line-interface (CLI) to migrate an existing Parse app to Back4App
Last updated a year ago by back4app .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @back4app/m2b4a -g
SYNC missed versions from official npm registry.

m2b4a - migrate-to-back4app

Command-line-interface (CLI) for migrating an existing app to Back4App: https://www.npmjs.com/package/@back4app/m2b4a

1 - Install Node.js (>= 8) and npm

If you don't have Node.js or npm installed in your machine, please take a look in this link: https://www.npmjs.com/get-npm

2 - Install @back4app/m2b4a

npm install -g @back4app/m2b4a

3 - Optional: Migrating from Buddy?

This is an optional step only for users migrating from Buddy.

  1. Access https://parse.buddy.com/
  2. Select the app you want to migrate
  3. Click in App Settings
  4. Click in Export database option
  5. Wait for an e-mail with your data
  6. Unzip the data file you received and take note of the folder path in which you extracted its content (it is your "dump-path" and you will need it in the next step and in 5 - Execute the migrate command)
  7. Open a terminal and go to the folder you extracted your Buddy data
  8. Download your files in a subfolder (take not of this subfolder path because it is your "files-path" and you will need it in 5 - Execute the migrate command):
mkdir files
cd files
wget -i ../fileList.txt                   # <-- Back4App recommendation

# or using curl
xargs -n 1 curl -O < ../fileList.txt      # <-- Buddy default

TIP: If a file name has a space character you can have problems using curl. Try to use wget command.

4 - Execute the migrate command


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

5 - 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.

6 - 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 the step 4.

7 - 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!

8 - Optional: Import your cloud code using our CLI


  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 htmls, 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).

9 - Getting help

If you need any assistance, please open a ticket at https://www.back4app.com or schedule an appointment with our engineering team using this link: https://calendly.com/back4app/

Current Tags

  • 1.2.10                                ...           latest (a year ago)

16 Versions

  • 1.2.10                                ...           a year ago
  • 1.2.9                                ...           a year ago
  • 1.2.8                                ...           a year ago
  • 1.2.7                                ...           a year ago
  • 1.2.6                                ...           a year ago
  • 1.2.5                                ...           a year ago
  • 1.2.4                                ...           a year ago
  • 1.2.3                                ...           a year ago
  • 1.2.2                                ...           a year ago
  • 1.2.0                                ...           a year ago
  • 1.0.5                                ...           a year ago
  • 1.0.4                                ...           a year ago
  • 1.0.3                                ...           a year ago
  • 1.0.2                                ...           a year ago
  • 1.0.1                                ...           a year ago
  • 1.0.0                                ...           a year ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 16
Last Month 32
Dependencies (8)
Dev Dependencies (0)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |