Migration to Confluence Cloud
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 |
|---|---|---|
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 |
|---|---|---|---|
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:
Configure Access to Bitbucket Cloud
Configure Access to Bitbucket Data Center
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.
Selecting the Bitbucket Edition:
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.
If the repositories are now on Bitbucket Cloud, select this option and configure the corresponding Bitbucket Cloud workspace.
The repository must be named the same as before the migration.