1. Guides
  2. Migrate from Serverless Cloud
Guides

Migrate from Serverless Cloud

Use this guide to easily migrate your Serverless Cloud apps along with their data, storage and parameters to the Ampt platform.

Important Note

Ampt is currently in PRIVATE BETA. If you're a Serverless Cloud user with an existing app and you don't have an Ampt account, please sign up for the waitlist and email support@getampt.com.

Migrate your Serverless Cloud app
1
Install the Ampt CLI
In your terminal, make sure you have Node.js v15+ and npm installed. Then run the following command to install the Ampt CLI.
Terminal
npm i -g @ampt/cli
2
Start the Ampt CLI
Navigate to your Serverless Cloud project folder and run ampt to create the app and spin up a new developer sandbox. This will prompt you to install the @ampt/cloud package.
Terminal
amptampt (beta)⚠︎ This looks like a @serverless/cloud project.Install @ampt/cloud to allow it to run on Ampt, or migrate your project to use the Ampt SDK.
3
Install @ampt/cloud

Using the Ampt CLI prompt, install the @ampt/cloud package.

In most cases, this will be the only step needed for migration. However, if you're migrating a Next.js, Remix, or Astro app, you'll need to make minor adjustments to your config files. Consult the documentation for the necessary changes.

Terminal
ampt (beta) install @ampt/cloud
4
Migrate data, storage, and params
Type open in to the Ampt CLI to open your Ampt Dashboard (ampt.dev). Click on your developer sandbox environment, then click "Migrations" in the top navigation bar.
Terminal
ampt (beta) open
5
Connect your Serverless account

On the Migrations page of the dashboard, click the "Connect a Serverless account" link. Login to your Serverless account using the email/password or Social Login associated with your Serverless Cloud account.

Once logged in, you'll be redirected back to the Migrations page.

Connect a Serverless account
6
Start a migration

Click the "Start a new migration" button and then select the options for your migration.

Select the Serverless Cloud instance you wish to migrate from the drop down menu.

Clear data before import will delete any data in the target environment's data table. This is useful for reimporting data after testing.

Copy parameters will copy over the source instance's Org parameters as well as the app and instance level overrides. NOTE: Org parameters and App overrides will not overwrite values that already exist. If you want to reimport a value, delete the parameter from the Ampt dashboard.

Copy storage will copy any Serverless Storage objects to Ampt Storage. NOTE: This will overwrite objects with the same name.

Copy data will copy Serverless Data items to Ampt. NOTE: This will overwrite existing items with the same keys.

Click "Start migration" to start the process. NOTE: Depending on the amount of information being migrated, this could take several minutes.

7
Test and deploy your app

Test the application in your developer sandbox to ensure everything is running correctly.

Once you've verified your app is working, deploy it to a permanent stage such as prod

Terminal
ampt (beta) deploy prod
8
Migrate production data, storage, and parameters
Once your app has deployed, go back to the Ampt Dashboard (type open in the Ampt CLI), navigate to the permanent instance you just created, and start a new migration.
Start a new migration
9
Transfer your custom domain

Be sure to run any final tests against your permanent stage in Ampt before transferring your domain name.

When you're ready to send traffic to your app on Ampt, you can detach the custom domain (if any) from your Serverless Cloud app and assign it to your permanent stage on Ampt.

NOTE: You may want to re-migrate your data and/or storage once the domain is transferred in case any production data may have changed.

Congratulations, your Serverless Cloud app is running on Ampt! 🚀

You can now manage your apps through the Ampt dashboard and develop using the Ampt CLI. If you have any existing Github integrations or CI/CD pipelines, please be sure to update them accordingly to use Ampt.

If you have any issues, please visit our Discord or email us at support@getampt.com.

Ampt is in private beta. Join the waitlist to get updates and early access.