Skip to main content

AppCenter Migration

Welcome to the AppCenter Migration guide. This guide will help you migrate your applications, CodePush versions, and metrics from App Center to NextPush.

Why migrate?​

Wouldn't you like to continue right where you left off? Yes, you can!
Check out the benefits of migrating to NextPush:

  • You can effortlessly import your existing applications.
  • All your data will be transferred to NextPush in just 1-2 minutes.
  • Your deployment key and other important keys remain unchanged.
  • Your application names stay the same.
  • All your versions are migrated.
  • All your statistics and analytics are transferred to NextPush.

✅ With just one command! Yes, with a single command, you can pick up right where you left off.

Step 1: Create a NextPush account​

If you don't have a NextPush account, you can create one at NextPush.center.

Step 2: Get your App Center API key​

  • You can get your App Center API key from here.
  • Set Description as "nextpush" and select "Read Only" access. Then click "Add new API token"
  • Copy the generated API key

Step 3: Migrate your applications​

You can migrate in two different ways:

  1. Using the Dashboard UI
  2. Using the CLI

Using the Dashboard UI​

  1. Go to the App List page
  2. Click on the "Migrate from App Center" button
  3. Enter your App Center API key
  4. Click on the "Migrate" button

Using the CLI​

Run the following command to migrate your data from App Center to NextPush.

First, install the NextPush CLI using npm:

npm install -g nextpush-cli

Then, login to your NextPush account.

nextpush login

Finally, run the following command to migrate your data from App Center to NextPush.

nextpush migrate --api-key <your-appcenter-api-key>

Step 4: Verify the migration​

After the migration is complete, you can verify it by checking the App List page.

Important Notes​

  • The migration process is instant. It may take a few minutes to complete. App Center allows only 500 API calls per 5 minutes, so if the migration fails, you can try again later.
  • The migration process is not atomic. If it fails, you can try again.
  • Your username will be updated based on the data imported from AppCenter.
  • Only applications you own will be imported. If you are an organization member, please use the organization owner's API key.
  • You can perform this import process multiple times with different API keys.
  • Applications with names that already exist in your account will not be imported.

Configuration​

Please follow the Configuration guide to configure your project.