How to migrate a project with its repo's from one bitbucket server to another bitbucket server

Question

In our company we configured  two bitbucket Server installations in different ways.

Bitbucket Server A is configured by maintaining a local user administration and uses the embedded H2 database delivered with the software.

Bitbucket Server B performs the authentification via Active Directory and ist connected to an external MS SQL Server DB.

Now we plan to migrate the existing projects (with repo's, hooks, webhooks  admissions defined etc. )  from Bitbucket Server A to Bitbucket Server B.

What is the recommended way to migrate without loss of data /metadata?

Bettina Carl · Answer

Hi Caterina,

> That's an interesting setup. Any reasons for it?

No, there was no special reason - just the fact that development department started to work with bitbucket in a testenvironment in order to get experience, while I was setting up the "official" bitbucket environment.

Now we would like to migrate the entire instance with its directories and settings. But as we have a user administration configured in different ways, I guess the permissions cannot be mapped 1:1 from one instance to the other.

>In this case, the recommended option would be to take a backup from the source instance and restore it on the target one

I know that documentation... it is not an option as we will loose all work having already done in the target instance (~60 repos). So I voted for BSERV 4586 ;-)

Best regards
Bettina

Caterina Curti · Answer

Hi @Bettina Carl,

That's an interesting setup. Any reasons for it?

Is the plan to migrate the entire instance (including user directories, add ons and all settings) from one server to the other?

In this case, the recommended option would be to take a backup from the source instance and restore it on the target one. All details and attention points are documented on the Migrating Bitbucket Server to another server page.

Moving individual projects or repositories instead is not possible. We have an open feature request on this topic:

- BSERV-4586

Cheers,

Caterina - Atlassian