Skip to main content
Skip table of contents

Migration path from On-Premises to the Cloud for GitHub links for Confluence

This documentation provides information on how to migrate from the GitHub links for Confluence Data Center app to Cloud.

Migration Assistant support is not available yet

We are actively working on support for Migration Assistant. Once released, GitHub macros will be carried over automatically during migration. Until then, please follow the manual procedure below.

Prerequisites

Before you start, make sure you have:

Migration Steps

Step 1. Migrate your Confluence content to the Cloud

To start this journey, it is recommended to use Cloud migration methods for Confluence to ensure a successful migration.

If you use Atlassian Migration Assistant, on Confluence Data Center, go to Confluence administration → General configuration → Migration Assistant and run the Confluence Cloud Migration Assistant for your spaces, pages, users and attachments.

After the Migration Assistant runs:

  • All your pages, spaces, and attachments will be available on Cloud.

  • Any GitHub macros embedded on these pages will appear as unknown or unrendered macros in Cloud because they haven't been automatically migrated yet. They must be recreated manually (see Step 3).

Step 2. Configure the GitHub integration in Confluence Cloud

As a Confluence administrator, connect your Confluence Cloud instance to your GitHub instance and verify the connection.

For the full step-by-step procedure, see the GitHub links for Confluence (Cloud) setup guide.

Step 3. Recreate GitHub macros on the migrated Cloud pages

Because GitHub macros are not yet migrated automatically, on each Cloud page that previously contained GitHub content, you'll need to:

  1. Edit the page in Confluence Cloud.

  2. Remove the unknown/unrendered Data Center macro placeholder.

  3. Create the equivalent GitHub macros (type / and search "GitHub links"). See the macro creation guide.

  4. Publish the page.

Important considerations

  • Macro feature parity. Not all macros available on the Data Center version are currently supported on Cloud. Please review the differences article before migrating.

  • Configuration parameters differ. The available fields and options for each macro on Cloud may differ from those in the Data Centre. Adjust the macro settings to match your intended display.

  • Authentication model differs. For connection to GitHub, the Data Center supports Personal Access Token only, whereas the Cloud supports either a GitHub App or a Personal Access Token.

Need help?

If you have any questions or need help with migration, please contact our Support Team. Our dedicated team will answer all your questions and expertly guide you through the entire migration process.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close