Migrating Confluence to Atlassian Cloud

This guide provides step-by-step instructions for migrating your existing Confluence server or Data Center instance to Confluence Cloud.

1. Pre-Migration Assessment

  • Evaluate Current Spaces: Review the existing spaces, pages, and content hierarchy. Identify critical content and customizations.
  • Customizations and Integrations: Document any custom macros, plugins, or integrations that are essential for your Confluence setup.
  • Security Audit: Review the current space permissions, user roles, and any restrictions in place. Ensure you have a clear understanding of how data access is managed.

2. Prepare for Migration

  • Backup Confluence Data: Perform a full backup of your Confluence instance, including the database, attachments, and configuration files.
  • Review Atlassian’s Confluence Migration Guide: Familiarize yourself with the process through the Confluence Server to Cloud Migration Guide.
  • Test Migration: Set up a staging environment to conduct a test migration. Use this environment to identify potential issues, especially with large spaces or custom macros.

Security Implication

Ensure the backup is encrypted and stored securely. Access should be restricted to avoid unauthorized access, especially since Confluence may contain sensitive documentation.

3. Migrating to Cloud

  • Install Confluence Cloud Migration Assistant: Use this tool to plan and execute the migration.
  • Space and User Mapping: Carefully map spaces and users to ensure a smooth transition. Pay attention to space permissions and user roles during this process.
  • Run a Test Migration: Before the final migration, run a test migration to ensure that the content is correctly transferred and that there are no issues with custom macros or integrations.
  • Final Migration: Execute the final migration, ensuring that all spaces, pages, and users are migrated to the cloud environment.

Important Step

Space Permissions: Incorrect mapping of space permissions can lead to unauthorized access or loss of access for key users. Double-check permissions to ensure they align with your organization’s security policies.

4. Post-Migration Tasks

  • Review Migrated Content: Validate that all content, spaces, and users have been migrated correctly. Check for any issues with formatting, broken links, or missing attachments.
  • Reconfigure Plugins: Some server plugins may not have cloud equivalents. Identify alternatives or workarounds for these.
  • Security Settings: Review and update the security settings in Confluence Cloud, including space permissions and user roles.

Security Consideration

Access Controls: Implement and review access controls in the cloud environment. Ensure that sensitive spaces are properly restricted and that users have the appropriate level of access.

5. Resources