Getting started with AWS Migration Hub - AWS Migration Hub

Getting started with AWS Migration Hub

In this section, you can find information about how to get started with AWS Migration Hub. Included are steps to introduce you to the initial console pages that Migration Hub presents to a new user.

Before you begin, be sure to set your home region, either from the console or by using commands in the CLI. The first time you view the Migration Hub console, you'll be prompted to choose a home region. You can choose and view your current home region on the Migration Hub Settings page. To navigate to the Settings page, choose Settings in the left navigation pane. After the home region is set, it cannot be changed.


If you are a developer or are interested in sending migration status from a migration tool, script, or custom code, see AWS Migration Hub API and AWS Migration Hub Home Region API reference.

All Migration Hub and Application Discovery Service API commands must be called from within the home region only, and they require you to call GetHomeRegion at least once before you call any other API, to obtain the account's Migration Hub home region. Calls originating from outside your home region are rejected.


For the Migration Hub walkthroughs, we make the following assumptions:

  • You have signed up for AWS. For more information, see Setting up.

  • You have selected your Migration Hub home region.

Here's what to expect:

  • Migration Hub monitors the status of your migrations in all AWS Regions, provided that your migration tools are available in each region.

  • The migration status of every AWS Region undergoing migration is shown in your home region console.

  • The migration tools that integrate with Migration Hub store all data about your migration status in Migration Hub. The data is stored in your selected home region.

  • The migration tools do not send status unless you have authorized (that is, connected) them.

  • For a list of AWS Regions where you can use Migration Hub, see the Amazon Web Services General Reference.

  • For more information about working with your home region, see the section about Home regions.

Access to AWS Migration Hub

AWS Migration Hub tracks the status of application migrations on the AWS Migration Hub console in your home region. The Getting Started section and other sections of this guide use the console to illustrate migration functionality. Open the AWS Migration Hub console at

Additionally, you can use the AWS Migration Hub API to track the status of your migrations from other tools or to send custom migration status to AWS Migration Hub. For more information about the Migration Hub API, see AWS Migration Hub API. You'll also need to call the GetHomeRegion API from the Migration Hub home region API when working with Migration Hub programmatically.

The AWS SDKs assist you to develop applications that interact with Migration Hub. The AWS SDKs for Java, .NET, and PHP wrap the underlying Migration Hub API to simplify your programming tasks. For information about downloading the SDK libraries, see Sample Code Libraries.

Two ways to get started

If this is the first time you are using Migration Hub, you will be prompted to choose your home region in the console before beginning a migration.

To begin your migration, open the AWS Migration Hub console at, and in the navigation pane choose Dashboard.

If you have not sent any data to Migration Hub yet, you'll see the AWS Migration Hub page where you're given the option to choose one of the two migration workflows. Choose either Get started with discovery or Get started migrating.

        Getting started dashboard.