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:
Go to your Bitbucket: click Administration ⚙ > Manage apps > Pages for Bitbucket
Click the Edit icon next to the Licence key field.
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 migration approach when 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!