AWS Migration Hub is no longer open to new customers as of November 7, 2025. For capabilities similar to AWS Migration Hub, explore [AWS Transform](https://aws.amazon.com/transform).

# Tutorials
Tutorials

Before you do the following tutorials, we recommend that you first read [What is AWS Migration Hub Journeys?](what-is-mhj.md)

**Topics**
+ [

# Creating a migration journey from a template
](template-migration-tutorial.md)
+ [

# Creating a custom migration journey
](custom-migration-tutorial.md)

# Creating a migration journey from a template
Template journey

In this tutorial you create a migration journey that uses the general migration template. After you create the journey, you add and remove tasks to customize the journey. You also send invitations to teams and individuals so that they can join the journey as members and work on it. Finally, you set start and finish dates.

**Create the migration journey**

1. Open the Migration Hub Journeys console. For information about how to access the console, see [Accessing AWS Migration Hub Journeys](setup.md).

1. In the navigation pane, choose **Migration journeys**.

1. Choose **Create migration journey**.

1. In the **Journey creation method** section, keep the default, which is **Use AWS Migration Hub Journeys template**.

1. Under **AWS templates**, choose **General migration**.

1. In the **Journey details** section, under **Journey name** enter **general-migration-tutorial-journey**.

1. Under **Migration space**, choose **Create migration space**.

1. In the **Migration space name** field, enter **test-space**.

1. Choose **Create migration space**.

1. Choose **Create migration journey**.

It might take Migration Hub Journeys up to a minute to create the journey for you. The following image shows the journey overview that you see when the journey is ready.

![\[alt_text\]](http://docs.aws.amazon.com/mhj/latest/userguide/images/successfully-created-journey.png)


To finish setting up the journey, you invite team members to participate in the journey, then you edit its contents to match your specific migration scenario. 

**Invite members**

In this procedure, you invite two people to join the migration space that you created when you were creating the journey. 

1. In the navigation pane, choose **Migration spaces**.

1. To go to the details page of the migration space, choose the name **test-space**.

1. On the details page, choose the **Individuals** tab that is shown in the following image.  
![\[alt_text\]](http://docs.aws.amazon.com/mhj/latest/userguide/images/migration-space-individuals.png)

1. Choose **Invite**.

1. Enter the email address of a person that you want to work with you on migrations, 

1. For **Role**, choose **MigrationSpaceContributor**. 

1. Choose **Invite**.

1. Back on the **Individuals** tab, choose **Invite** again.

1. Enter another email address to invite a second person to become a contributor to the migration space.

1. In the navigation pane, choose **Migration journeys**.

1. In the list of journeys, choose the name **general-migration-tutorial-journey**.

1. On the journey details page, choose the **Individuals and teams** tab that is shown in the following image.   
![\[alt_text\]](http://docs.aws.amazon.com/mhj/latest/userguide/images/journey-individuals-and-teams.png)

1. Choose **Invite**.

1. Under **Individual**, select one of the two individuals that you invited to the migration space.

1. For **Role**, choose **JourneyContributor**.

1. Choose **Invite**.

1. Choose **Invite** again and repeat the previous steps to invite the other individual that you had invited to the migration space. For this individual, choose the **JourneyAdmin** role.

**Customize the journey**

The general-migration template includes tasks for performing a Migration Readiness Assessment (MRA). In this tutorial we imagine a scenario where you've already performed an MRA. Therefore, the MRA tasks aren't needed. In the following procedure, you delete the MRA tasks, and you attach your MRA report to the journey.

1. Choose the **Tasks** tab that is shown in the following image.   
![\[alt_text\]](http://docs.aws.amazon.com/mhj/latest/userguide/images/tasks-tab.png)

1. Choose the task **MRA - Review objectives and best practices**.

1. On the task details page, choose **Actions**, and then choose **Delete**, as shown in the following image.  
![\[alt_text\]](http://docs.aws.amazon.com/mhj/latest/userguide/images/delete-task.png)

1. In the dialog box, type **delete**, then choose **Delete**.

1. Choose the task that is titled **Perform MRA pre-workshop activities**. This task has three subtasks.

1. To delete a task, you must first delete all of its subtasks. Choose the subtask **Pre-workshop Questionnaire**. On the subtask's details page, choose the **Actions** menu, and then choose **Delete**.

1. In the dialog box, type **delete**, then choose **Delete**.

1. Go back to the **Perform MRA pre-workshop activities** task and delete its two remaining subtasks.

1. Delete the **Perform MRA pre-workshop activities** task.

1. On the journey's **Tasks** tab, choose the task **Perform MRA workshop activities**.

1. On the task's details page, choose the **Attached files** tab.

1. Choose **Choose file**, and then upload your company's MRA report. For this tutorial, you can upload any example file, even if it's an empty file.

1. Go back to the journey's **Tasks** tab, and move the **Perform MRA workshop activities** task to the **Completed** column as shown in the following image.  
![\[alt_text\]](http://docs.aws.amazon.com/mhj/latest/userguide/images/completed-task.png)

# Creating a custom migration journey
Custom journey

In this tutorial, you create a custom journey for the following migration scenario: [Rehost on-premises workloads in the AWS Cloud: migration checklist](https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/rehost-on-premises-workloads-in-the-aws-cloud-migration-checklist.html#rehost-on-premises-workloads-in-the-aws-cloud-migration-checklist-epics).

**Create the migration journey**

1. Open the Migration Hub Journeys console. For information about how to access the console, see [Accessing AWS Migration Hub Journeys](setup.md).

1. In the navigation pane, choose **Migration journeys**.

1. Choose **Create migration journey**.

1. In the **Journey creation method** section, choose **Create custom journey**.

1. In the **Journey details** section, under **Journey name** enter **custom-migration-journey**.

1. Under **Migration space**, choose **Create migration space**.

1. In the **Space name** field, enter **tutorial-two-space**.

1. In the **Create phases** section, enter **Planning phase** in the **Phase name** field.

1. Choose **Add phase**, and then enter **Pre-discovery** in the **Phase name** field.

1. Repeat the previous step to add four more phases with the following names: **Discovery**, **Build**, **Test**, and **Cutover**.

1. Choose **Create migration journey**.

**Add a module to each of the phases of the journey**

In this procedure, you add a main module to contain the tasks that you will later add to each phase.

1. In the navigation pane, choose **Migration journeys**.

1. Choose the name of the journey **custom-migration-journey**.

1. Choose the journey's **Modules** tab.

1. In the **Modules in the Pre-discovery phase** section, choose **Add module**.

1. In the **Title** field, enter **Main module**.

1. For the **Phase** field, use the dropdown list to choose **Pre-discovery**.

1. Choose **Add module**.

1. Repeat the steps in this procedure to add a module to each of the phases of the journey.

**Add tasks to the modules of the journey**

1. In the journey's **Modules** tab, find the **Modules in the Pre-discovery phase** section, and choose **Main module**.

1. Choose **Create task**.

1. In the **Title** field, enter **Groom the pre-discovery backlog.**.

1. For the **Module** field, choose **Pre-discovery main module** from the dropdown list.

1. For the task description, enter **Conduct the pre-discovery backlog grooming working session with department leads and application owners.**

1. Choose **Create task**.

1. Repeat the steps in this procedure to add to the journey all of the tasks that are listed under [Epics](https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/rehost-on-premises-workloads-in-the-aws-cloud-migration-checklist.html#rehost-on-premises-workloads-in-the-aws-cloud-migration-checklist-epics).