Cloud Migration Assistant for Confluence

Migrate from Confluence Server to Cloud

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The  Cloud Migration Assistant for Confluence is an app that  helps you easily export spaces from Confluence Server and import them to Confluence Cloud. Built and maintained by Atlassian, the app is free to install and use.

Once installed, you can select individual or multiple spaces to move to the Cloud, start migrating at your convenience, and monitor the progress of each space throughout the migration process. 

Before migrating, make sure you check out Plan your Confluence Server to Cloud migration and the Atlassian Cloud Migration Center.

What to know before you migrate

Migrating users and groups

  • The Cloud Migration Assistant for Confluence only migrates spaces. It will not yet migrate your users or groups to Confluence Cloud. We recommend adding your users to Confluence Cloud before migrating spaces. If you have a large number of users, please contact support to help you move your users.

Pre-migration checklist

Migration troubleshooting

  • Every space in your Confluence Cloud site must have a unique space key. If a space key already exists in your Confluence Cloud site, trying to migrate a space with the same space key will cause that individual space migration to fail, and will result in an overall Failed migration plan status. However, some spaces may have been migrated successfully.
  • After migrating spaces, it can take some time for them to appear in the space directory. However, they can be accessed via a direct link. 
  • This app will not be available if installed on Confluence Data Center.

When to use Cloud Migration Assistant for Confluence

  • After you've migrated your Jira Server instance (with your users) to Jira Cloud, and you're ready to migrate to a new Confluence Cloud site.
  • After you've migrated your users, and you're ready to migrate your entire Confluence Server site to a new Confluence Cloud site.
  • When you're migrating Confluence Server spaces to an existing Confluence Cloud site.
  • When the Atlassian Support team has recommended using the app.

Step 1: Move your users from Server to Cloud

The Cloud Migration Assistant won't migrate your users to Confluence Cloud. To maintain associations between your users and the migrated data, add your users to your Confluence Cloud site before migrating spaces.

You can add users to Confluence Cloud in one of three ways:

  1. If you are migrating both Jira and Confluence, migrating Jira first will migrate all of your users to the cloud. Before migrating, make sure all your Confluence users are also in Jira. Then, after migrating Jira Server to your Atlassian Cloud site, use the Cloud Migration Assistant for Confluence to migrate your Confluence Server spaces as well.
  2. If you have a small number of users, you can manually add them to your Atlassian Cloud site before migrating. 
  3. If you have a large number of users, get in touch and we can help assist with your migration. 

Step 2: Install the Cloud Migration Assistant for Confluence app

Before using the app, there are a few things to check:

To install the app:

  1. In Confluence Server go to  > Manage apps.
  2. Choose Find new add-ons
  3. Search for the Cloud Migration Assistant for Confluence app. 
  4. Choose Install and you're all set.

If your Confluence Server site is behind a firewall, you'll need to allow outgoing traffic to your new Cloud site, as well as to

Step 3: Use the app to plan and run your migration

Analyze your site

  1. In Confluence Server, go to  > General Configuration > Migration Assistant
  2. Choose Explore migration > Run analysis

The analysis evaluates your Confluence Server site and displays the number of spaces, pages, and attachments contained in your current environment. It will also provide an estimate for the amount of time it will take to migrate all your spaces.

tip/resting Created with Sketch.

You don't need to migrate everything at once. You can migrate a single space, several spaces, or all your spaces at any time.

Create a migration plan

Now that you've checked out the analysis of your Confluence Server site, it's time to create your migration plan. Creating a migration plan means selecting specific spaces or data you want to migrate to Confluence Cloud. You can select the spaces that you want to include in each cloud migration plan that you create, so you have control over what's in each plan as well as when you'll move each migration plan to Atlassian Cloud. For example, if you wanted to migrate your site in three stages, you could create three plans, with different spaces in each. 

To create a migration plan:

  1. Choose Create plan.

Select the spaces you want to add to your migration plan. You can filter the list or search for particular spaces, or Select all if you want to migrate everything at once. You will not be able to migrate spaces with space keys that already exist in your Confluence Cloud destination site. Trying to do so will result in a Failed migration plan status, and those spaces won't be migrated.

  1. Choose Add items to plan.   
  2. Add a name for your migration plan in the Migration plan name field. 
  3. Click Choose cloud site and follow the prompts to log in to your Atlassian Cloud account (if you're not already logged in). 

  4. The sites associated with your Atlassian Cloud account will be listed in the Migration destination menu. If the current account is not correct, click Change account to log in with a different account.

  5. Select your site from the Migration destination field, then choose Confirm

  6. Choose Review plan

  7. Review your migration plan. If everything looks correct and you want to start your migration, click Run. If you would like to start your migration later from your migration dashboard, click Save.

If you choose to run your migration plan, it will still be saved to your migration dashboard. There, you can view the progress and details of the migration to Atlassian Cloud.

Manage your migration plans

Your saved migration plan will be listed on the migration dashboard, where you can view its details or run it. You can also check the status of a plan, monitor the progress of a migration plan that is currently running, stop a plan that's currently running, or create a new plan.

You can create as many plans as you need. At this time, migration plans can't be deleted, so if you create a plan that can't be used, just create a new plan to continue your migration to the Cloud.

Plan status definitions

Ready: Your migration plan is ready to run.

Running: Your migration plan is currently in progress.

Stopped: Your migration plan has been stopped. Once stopped, it can't be resumed. Any step already in progress will first need to finish before the plan is shown as fully stopped. Some spaces may already have been migrated to your Confluence Cloud site.

Finished: Everything in your migration plan has been migrated.

Failed: We were unable to complete the migration plan. This might be because the space key already exists in the destination site, or the migration hit an unexpected error.

Run a saved migration plan

To run your plan:

  1. In Confluence Server, go to  > General Configuration > Migration Assistant.
  2. Choose Run beside the plan you want to run.
  3. The first time you run a migration plan, you will be asked to confirm that you agree to Securely share your migration data with Atlassian to begin the cloud migration process. This allows Atlassian to securely copy data from your Confluence Server site to your Confluence Cloud site. 
  4. Use the progress bar beside the migration plan to check the progress, or choose View details to see a space-by-space summary.
  5. After migrating spaces, it may take a while for them to appear in the space directory. However, they can be accessed via a direct link. 

Leave a review

Your feedback is invaluable in helping us improve our products. Please take a moment to let us know what you think by leaving a review of the Cloud Migration Assistant for Confluence on the Atlassian Marketplace. 

More information and support

Last modified on Nov 26, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.