CCMA Migration Process

What you need before you start:

  • A Confluence Server instance (with the latest update of Atlassian Migration Assistant)
  • A Confluence Cloud instance with Forms for Confluence Cloud installed
  • On both instances:
    • Confluence admin permissions
    • Space admin permissions.

How to prep:

You will need administrator permissions for the Server/DC instance and the Cloud site. 


The process for migrating Forms data using the Confluence Cloud Migration Assistant is as follows:

  • Set up an appropriate Confluence for Cloud instance as the target instance for migration.
  • Refresh the connection between the Confluence instance and the migration service.
  • Migrate your content, users, and the current workflow state using the Confluence Cloud Migration Assistant *.

*It is recommended that you create a migration for each individual space.

Migrations dashboard

The Migrations Dashboard is the action and information hub for the Confluence Cloud Migration Assistant. The dashboard indicates the user who executed an action, the progress, status, and other actionable items for each migration event. This is also the page where the Create new migration button can be found.

How to access the CCMA Dashboard:

  1. From a Forms for Confluence Cloud instance, click the Administration icon at the top of the page.
  2. Click General Configuration in the drop-down menu.

  3. The General Configuration screen opens. Find the Atlassian Cloud section in the left-hand menu and click Migration Assistant.

  4. The Migrations dashboard opens.

To perform your first migration from the Migrations dashboard:

Step 1- Asses

  1. Click Create new migration.

  2. The Assess apps pop-up appears. Click Assess apps.
  3. The App Assessment window opens, and the Forms for Confluence app appears in the table on the page. 
    1. Optional: Click View differences to see any conflicts between the existing data and the migration action.
    2. Optional: Change the Status of the Forms app, or others, depending on precise need.
  4. If satisfied, click Done; the Migration Assistant home page opens.

Step 2- Prepare

  1. Click Prepare Your Apps. The Preparation wizard opens.
  2. Use the Choose your destination cloud site dropdown option to connect a cloud site.
    Click Continue.
  3. The Install options appear.
    1. Optional: Install apps in cloud.
  4. Click Continue. The Migration Agreement appears.
  5. Click Done.

Step 3- Migrate

  1. Now returned to the Migrations dashboard, click Create new migration.
  2. The Migration Overview window opens. Click Connect to cloud.

  3. The Connect page opens. Add an original title in the Name your migration field.
    The Choose your destination cloud site dropdown is pre-filled from the earlier selection in the Preparation Wizard.

  4. Click Choose what to migrate. The Choose window opens.
  5. Select desired Spaces, Users and groups, and Apps. Click Next.
    The Choose spaces options appear.
  6. Select the associated checkbox for the connected space to be migrated. 
    Click Add to migration.

  7. The Check for errors window opens. View results and manage errors if desired.
    1. Click the Carrot next to any error to see more information. Click Refresh all to see the effect of an action at any time.
  8. When satisfied, click Review Migration.
    The Review Migration window opens.
  9. If satisfied with the Migration details, click Run now.
  10. The migration begins and appears under a Running status on the Migrations dashboard.
On this page