Migration to Confluence Cloud

Owned by Michael Rüegg
Last updated: Jan 31, 2022 by Sue Rocha
2 min read

Migration from Confluence Data Center to Confluence Cloud is supported to some extend.
Here is an overview of what features are supported including migration guides. Contact us when you have a scenario that is not directly supported.

Include App edition

Supports Bitbucket Cloud

Supports Bitbucket
Data Center and Server

Include App edition

Supports Bitbucket Cloud

Supports Bitbucket
Data Center and Server

Confluence Data Center and Server

(except Ant patterns)

Confluence Cloud

(only Bitbucket files)

The Data Center and Cloud Edition have different feature sets:

Feature

Confluence Data Center

Confluence Cloud

Automatic Migration Supported

Feature

Confluence Data Center

Confluence Cloud

Automatic Migration Supported

Bitbucket files

(with limitations)

Bitbucket files by Ant Patterns

(only Bitbucket Data Center)

Bitbucket open pull requests

(only Bitbucket Cloud)

Bitbucket Git branches

Bitbucket Git commits

Bitbucket Cloud issues

Migration from Confluence Data Center to Cloud

1. Limitations

Following limitations apply for migrating from Confluence Data Center to Cloud:

  • Only Bitbucket file macros are migrated automatically. All other macros (like e.g. the pull request or branches macro) have to be recreated.

  • The Bitbucket file macros are migrated in read-only mode. When you want to edit the macro parameters, you have to recreate the macro.

  • If the Confluence Cloud instance is connected to multiple Bitbucket instances, then the macro can’t determine the right Bitbucket instance. It will show manual migration steps in that case.

  • File ranges, regexes and hiding file headers is not supported.

2. Prepare Bitbucket instance

The Include Bitbucket for Confluence app supports both, Bitbucket Data Center and Cloud. You can choose to migrate to Bitbucket Cloud when migrating to Confluence Cloud as well, or keep the existing Bitbucket Data Center instance.

In case you keep your repositories on Bitbucket Data Center: it needs to be accessible via HTTPS on the public internet.

3. Configure Access to Bitbucket in Confluence Cloud

Configure access to Bitbucket in Confluence Cloud:

4. Migrate using the Confluence Cloud Migration Assistant

Use the Atlassian Cloud Migration Assiant to migrate the Confluence spaces.

Bitbucket Application Link replacement after migrating

After migrating from Confluence Data Center to Cloud, you must provide a fallback for the application link to Bitbucket for migrated macros.

  1. Selecting the Bitbucket Edition:

    1. If the referenced repositories are still on your Bitbucket Data Center instance, then select Bitbucket Data Center and provide the public URL to it. You must configure the Data Center settings as well.

    2. If the repositories are now on Bitbucket Cloud, select this option and configure the corresponding Bitbucket Cloud workspace.

  2. The repository must be named the same as before the migration.