This page describes the migration paths of Pages for Bitbucket and all its settings for various cases.

From Server to Data Center

Standard Atlassian Server → DC migration includes app data and configuration settings.

When migrating Bitbucket from Server to Data Center in one of Atlassian’s documented ways (update the license or migrate the database), the app data and settings are maintained with no further action required. All you need to do is update the license for both the platform and any apps.

Bitbucket Server to Data Center (in-place)

Migration is a straightforward task when upgrading your Bitbucket from the Server to the Data Center version on the same instance. Pages for Bitbucket is ready to use in a Data Center environment, and you only need to buy and apply the Data Center license.

Updating your Pages for Bitbucket license

To buy the Data Center app license, open the Pages for Bitbucket page at Atlassian Marketplace, click Buy it now, or use this direct link.

To update your license key:

  1. Go to your Bitbucket: click Administration ⚙ > Manage apps > Pages for Bitbucket

  2. Click the Edit icon next to the Licence key field.

  3. Enter the license key and click Update.

See Atlassian documentation for more details on switching from Server to Data Center Bitbucket version.

Bitbucket Server to a new Data Center instance

Full database migration

This case does not differ significantly from the process described in Bitbucket Server to Data Center (in-place). Once you migrate from one instance to another, all hook settings are also migrated. You only need to update the Pages for Bitbucket license when migrating to a different instance type.

Migrating selected projects

To migrate specific projects or repositories, we recommend cleaning up Bitbucket first by removing any unwanted projects or repos and using the standard Bitbucket front-end (or the Bitbucket REST API for teams that are comfortable scripting). Once Bitbucket server has only the projects and repositories you want, use a standard Bitbucket migration process to migrate the Bitbucket data. This is the safest and most straightforward approach to combining migration and cleanup tasks.

From Server / Data Center to Cloud

There is no Cloud version of Pages for Bitbucket at this time. We are in contact with Atlassian on this topic and will add a cloud version of Pages for Bitbucket as soon as the technical ability becomes available.

If you are interested in a cloud version, contact us and let us know!