Plan your Confluence Server to Cloud migration
Confluence server to cloud migration resources
On this page
- No related content found
Still need help?
The Atlassian Community is here for you.
|description||Use this guide to plan every step of your migration from Confluence Server or Data Center to Confluence Cloud. Find all the documentation and resources to help you make the move.|
This guide provides a high-level plan for migrating a self-hosted Confluence Server or Data Center site to Confluence Cloud. Before getting started, learn more about migrating to Atlassian's cloud products and check out our migration FAQs.
Here, we'll cover enlisting your project team, evaluating technology options, ensuring that your self-hosted environment is ready for migration, and executing the migration.
Some of the steps in this guide require advanced permissions. Before you begin, you may want to check that you:
The first step to any migration is understanding your current landscape, and where you're headed.
- Review your security and compliance requirements: Adhering to your organization's security requirements is critical to a successful migration. For more information about Atlassian's security, privacy, and compliance policies, check out Trust at Atlassian. At this point, you may need to engage with your procurement or security teams to ensure Confluence Cloud meets your requirements.
Evaluate apps: Before deciding to migrate, review any apps and custom integrations you may have to determine what you'll need for your Confluence Cloud site. To help you through this, we've put together some advice and best practices.
The Atlassian Marketplace offers a large selection of apps and integrations that extend the functionality of Confluence Cloud. These include free integrations with leading SaaS productivity and collaboration products like Slack and Dropbox, and subscription-based licensing of some of your most beloved Server apps.
Keep in mind while you're evaluating that while Atlassian’s cloud and server products provide the same benefits, they can differ in features and functionality. In some cases, you may discover that the cloud version of a product includes functionality that is fulfilled through an app on server. You may also have in-house or custom-built apps to consider.More on migrating apps to cloud
App data is not included when migrating from Confluence Server to Confluence Cloud. This includes apps from Atlassian, like Team Calendars for Confluence and Questions for Confluence. Some apps do have the capability to export and import their data but you'll need to check with the app developers or their documentation to confirm if this is possible.
If you do need to map third-party apps to Confluence Cloud, first check if there is a cloud equivalent of your server app in our Marketplace. If there is a cloud equivalent, your next step would be to check with the app developer to see if it stores any data. Not all apps store data. If it does, you'll need to work with the app vendor to understand your data migration options. Atlassian doesn't directly handle migrating data generated from third-party server apps to cloud apps. If there's no equivalent and the app stores data, you should still contact the vendor to see if there's a way to export the data.
Check costs: There's no cost to migrate to Confluence Cloud besides the cost of your Confluence Cloud subscription. However, you'll still want to assess your payment options and overall costs. A few things to keep in mind:
Atlassian offers extended cloud trials to self-hosted customers — at no cost — to help with your migration. This offer allows you to try cloud for an extended period, giving you time to assess, plan, test, and migrate from server to cloud — without having to pay for both products at once.
Unlike Confluence Server, Confluence Cloud is sold as a subscription, not a perpetual license. If you choose a Standard or Premium plan, you can opt to pay monthly or receive a discount for paying annually. Check out Confluence Licensing to decide which plan and billing cycle is best for your team.
Note that you can’t roll an active Confluence Server license into a Confluence Cloud subscription. These are two separate products and are paid for separately.
If you're planning on using Atlassian Marketplace apps in Confluence Cloud, remember to factor these into your cost considerations. To estimate your total cost — including which cloud products, plan, apps, and billing cycle you choose — try our cloud pricing calculator.
Now that you've decided to migrate, let's figure out how to get there.
- Review the FAQs: We've developed a comprehensive set of FAQs to assist you in planning your Confluence migration. If you have questions that we don't cover, let us know.
Compare plans: We offer multiple plans for Confluence Cloud: Free, Standard, and Premium. Free plans are useful for small teams with limited users and storage needs. Standard plans include 250 GB of storage. Premium plans are designed to give teams the confidence to scale reliably with advanced features, plus a 99.9% uptime SLA, unlimited storage, and 24/7 Premium Support.
Try out Confluence Cloud: Sign up for your extended cloud trial. (Or if the Free plan meets your needs, you can set up a site, directly.) While signing up, you’ll need to choose your Atlassian cloud site name (URL).Tips for choosing your site URL
The format for your site name will be https://example.atlassian.net, where example is a unique character string that you specify.
Site names are chosen for an entire Atlassian cloud site at the time you sign up for your first product — for example, when you first sign up for Jira Software Cloud or Confluence Cloud.
There are a few things to be aware of when choosing your site name:
Your unique character string must be at least three characters.
It can only contain letters, numbers, and hyphens.
Hyphens can't be the first or last character.
If you'd prefer a separate testing and staging environment, there are a few other ways to set this up which you can learn about here.
Keep in mind as you trial that the design and layout aren't the same across Confluence Server and Confluence Cloud, and you can't switch between the two. We recommend trialing Confluence Cloud before migrating to get comfortable with the differences and identify any communications or training needed to help onboard your users.
- Assemble your team: Migrating from Confluence Server to Cloud will have an impact on your users' experience and workflows, as well as various stakeholders throughout your organization. Depending on the size of your organization and number of users, a migration may require a fully fledged project with defined roles and responsibilities across teams. As early as possible, you should communicate with individuals and stakeholders who are interested and impacted by a move to Confluence Cloud. Where possible, recruit and enlist these people to be a part of the process.
- Communicate early and often: Beyond informing your organization about the migration schedule, share your migration plan with team members. Determine how you'll alert users about any issues or errors that arise. At this stage, your migration communication plan should cover things like:
- When will the migration occur?
- What downtime can users expect?
- Ask people to avoid changing anything during the transition.
- What will happen to the old site after migrating? Will it still be accessible or readable?
- Prepare your self-hosted site: Evaluate your current environment to determine if you need to make any changes before migrating your data.
- Check if you're on a supported server version. To use the Confluence Cloud Migration Assistant, you'll need to upgrade your Confluence Server to version 5.10 or later before migrating.
You may also want to take this opportunity to clean up or remove any unnecessary data. For guidance on what to clean up, refer to our migration testing guide.
- Review your anonymous access settings:
- If you don't want to allow anonymous users to access to your Confluence Cloud site without logging in, you'll need to check that anonymous access isn't enabled in server before migrating. Learn more at Setting Up Public Access.
- If you do want to allow anonymous access to some spaces, but not others, you need to first allow anonymous access in the global permissions for Confluence Cloud, and then review the space permissions for each individual space to determine whether they allow anonymous access. Disabling anonymous access in the Confluence Cloud global permissions will disable anonymous access at the space level as well.
If you need assistance with your migration, we have a wide network of partners globally that are very experienced in Atlassian migrations. Visit our Atlassian Partners page to find one who can help with your migration.
- Set up your organization: An organization allows you to view all of the Atlassian Cloud users at your company in one place, manage your users' accounts, and set up security features like SAML SSO. Organizations are particularly helpful if your company manages more than one cloud site and wants insight into all your sites, products, and the users who can access them. An organization is available for every site and can be accessed at admin.atlassian.com. Learn more about how to set up an Atlassian organization.
- Set up SSO: If you plan to use SSO in your cloud site, you should set this up in advance so that it will continue working seamlessly for your users when you migrate. Before setting up SSO, you'll need to verify a domain for your organization. Note that SSO requires a subscription to Atlassian Access, which you can trial free for 30 days. If you need more than 30 days to test, just reach out and we can extend your trial as needed.
Run a test migration: We recommend performing a trial run to ensure that your site's integrations, functionality, and performance are working as expected and the migration runs smoothly. Learn more about how to do this in our migration testing guide.
If you’re migrating from Confluence Data Center or have a large amount of data or attachments, we recommend breaking your migration into multiple smaller chunks. You can do this by selecting only some spaces at a time in the Confluence Cloud Migration Assistant.
- Install or migrate apps: Install and trial any apps you're planning to use on your cloud site, or if you're planning to migrate apps, work with the app vendor to migrate the data.
- Build a timeline: Identifying an ideal migration window can mean the difference between happy and frustrated users. Determine how much time your migration will take, factoring in time for troubleshooting. Consider scheduling the migration for overnight, on a weekend, or when your team is less likely to need access to Confluence. This will reduce the risk of data discrepancies between server and cloud.
After you have the necessary prerequisites in place and have completed the tasks associated with the pre-migration phase, you're ready to perform the migration. Follow the steps outlined below to migrate.
- Migrate to cloud: To perform the migration, use the Confluence Cloud Migration Assistant. When you migrate, the following data is imported:
- Site data, including spaces, pages and attachments.
- Users and groups.
The following is not imported:
- Global settings and permissions: These will need to be configured manually in your cloud site.
- Apps: You'll need to work with the app vendors to migrate or re-install your apps in Confluence Cloud after migrating. Note that apps from Atlassian, like Team Calendars for Confluence and Questions for Confluence, aren't included in the migration.
- Application links: If you plan to use Atlassian server products in conjunction with your Confluence Cloud site, you can create two-way links between your cloud and server products. If this applies to you, you can set set these up after migrating.
- User avatars: Users will need to update their avatars after migrating.
- Passwords: Users will need to reset their passwords after migrating (unless you're using SSO).
Not all migrations are quite so straightforward. Below are some of the common migration scenarios you may encounter, and guidance on how to approach each.
Merging server sites
If you need to merge multiple Confluence Server sites, just install the Confluence Cloud Migration Assistant on all server instances and move them separately to the Confluence Cloud site.
Keep in mind that every space in your Confluence Cloud site needs to 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 spaces' migration to fail.
Troubleshooting your migration
If you've run into a problem during your migration, we're here to help. You can start by searching for known issues in our public issue tracker. There, you can find information about some of the common issues we see with Confluence migrations, including their status and suggested workarounds.
Some known issues include the following:
- CONFSERVER-57776 - Getting issue details... STATUS
After you've successfully completed the migration, you'll need to go through a series of post-migration tasks to ensure that everything is functioning as smoothly and efficiently as possible before welcoming your team to cloud.
- Review your cloud site: When your migration is complete, you will need to review the new Confluence Cloud site to ensure your data and attachments have migrated successfully. Our testing guide outlines some recommended things to check for.
- Install or migrate apps: If you've identified apps that should be installed, add them to your Confluence Cloud site. If you have apps to migrate, work with the individual app vendors to migrate those a well.
- Set your server to read-only: If you’re no longer planning to run your server instance, you can set it to read-only mode after migrating to help with the switchover.
- Redirect users to the new cloud site URL: We recommend using site-wide banners both prior to your migration, to help alert users of your upcoming migration, as well as after migrating. This can help direct users still coming to server to your new cloud site URL.
- Welcome your team: Now that the migration is complete, make sure your organization is ready. Once migrated, you'll need to send an invitation or the link to your new site to your users so they can start using it. They will not be automatically invited. After you invite them, they'll also need to reset their passwords and avatars.
We recommend developing a comprehensive launch communication plan based on your User Acceptance Testing findings to share the new Confluence Cloud site information with the team. This can cover topics like:
What URL will they use to access the new site? For Confluence Cloud, the format to go directly to the homepage will be https://yoursite.atlassian.net/wiki, where yoursite is the unique character string of your cloud site URL. If you have both Jira and Confluence Cloud, users can also log in at https://yoursite.atlassian.net to access both.
Who can they contact with questions, and how? For example, can you provide a chat room or an issue tracker where people can raise any issues or feedback?
Are there any notable changes they'll need to be aware of? For example, changes in functionality due to different apps, or tips on how to navigate the new UI?
Links to any further reading or FAQs.
Let people know about the Confluence Cloud mobile app.
- Get acquainted with cloud: To learn more about what's new in Confluence Cloud and how to get the most of it, check out the Confluence Cloud documentation. Consider sharing this resource with your users if this is their first introduction to Confluence Cloud. You may also find the Atlassian Cloud documentation a helpful resource as you get started as a Confluence Cloud admin.
- Follow our cloud security best practices: Create a strong foundation for securing your company’s most important work. Learn more.
- Sit back and relax: Now that you're a cloud admin, you'll have immediate access to our latest features and bug fixes. Installs, upgrades, and patches are managed seamlessly by Atlassian, so you can relax on your weekends.
To keep track of major changes that affect all users of the Confluence Cloud products, follow the Atlassian Cloud Documentation blog. This includes new features, bug fixes, and other changes across all Atlassian Cloud products, for example, updates to the meeting notes templates or the ability to drag and drop spaces for easy space reorganization in Confluence Cloud.
More information and support
We have a number of channels available to help you with your migration.
- For more migration planning information and FAQs, visit the Atlassian Cloud Migration Center.
- Have a technical issue or need more support with strategy and best practices? Get in touch.
- Looking for peer advice? Ask the Atlassian Community.
- Want expert guidance? Work with an Atlassian Partner.
On this page:
- No related content found