Move from Atlassian Data Center to OpenProject

Take it out

1. 1

   Step 1

   Confirm the Jira version

   OpenProject's docs say the migrator supports Jira Data Center 10.x and 11.x only. Cloud is not supported. If you are on another version, stop and read the docs again.

2. 2

   Step 2

   Back up both sides

   The docs say the import changes OpenProject and that you can revert only while the run is still in review. Take a backup before you start.

3. 3

   Step 3

   Pick one project

   Do not start with every project. The docs tell you to migrate a small set, check it, and only then do the rest. Confluence spaces are not in this importer.

Put it in

1. 1

   Step 1

   Turn on the Jira Migrator on a test OpenProject

   In Administration, Import, add a Jira configuration. You need the Jira URL and a personal access token with admin rights. The docs say to enable project-based semantic identifiers first.

2. 2

   Step 2

   Test the connection, then import

   Use Test configuration. If Jira is on a private network, the docs say OpenProject blocks that call unless you set the SSRF allowlist. Choose the project, start the import, and leave it in review.

3. 3

   Step 3

   Approve only after a person checks the issues

   Review mode lets you revert. Approve makes it permanent and unlocks the new users. The docs say relations, sprints, workflows, and permissions are not imported yet. Recreate those by hand.

What you lose

• Confluence

  The wiki does not come along. Outline, BookStack, and Docmost are the wiki tools. Use the Confluence to Outline guide if that is the wiki you pick.

• Jira Service Management

  Queues and SLAs do not become OpenProject work packages. Zammad is the help desk on this list.

• Marketplace apps and permissions

  Apps, permission schemes, and workflows stay behind. Budget time to rebuild the ones people notice in the first week.