doc/workflow/importing/import_projects_from_bitbucket.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# Import your project from Bitbucket to GitLab

It takes just a few steps to import your existing Bitbucket projects to GitLab. But keep in mind that it is possible only if Bitbucket support is enabled on your GitLab instance. You can read more about Bitbucket support [here](../../integration/bitbucket.md).

* Sign in to GitLab.com and go to your dashboard

* Click on "New project"

![New project in GitLab](bitbucket_importer/bitbucket_import_new_project.png)

* Click on the "Bitbucket" button

![Bitbucket](bitbucket_importer/bitbucket_import_select_bitbucket.png)

* Grant GitLab access to your Bitbucket account

![Grant access](bitbucket_importer/bitbucket_import_grant_access.png)

* Click on the projects that you'd like to import or "Import all projects"

![Import projects](bitbucket_importer/bitbucket_import_select_project.png)

A new GitLab project will be created with your imported data. Keep in mind that if you want to Bitbucket users
to be linked to GitLab user you have to have all of them in GitLab in advance. They will be matched by their BitBucket username.

### Note
Milestones and wiki pages are not imported from Bitbucket.