2017-08-16 07:05:13 -04:00
# Migrating projects to a GitLab instance
2019-09-30 02:06:02 -04:00
1. [From Bitbucket Cloud ](bitbucket.md )
1. [From Bitbucket Server (also known as Stash) ](bitbucket_server.md )
2017-09-06 10:59:07 -04:00
1. [From ClearCase ](clearcase.md )
1. [From CVS ](cvs.md )
1. [From FogBugz ](fogbugz.md )
2017-10-24 01:58:38 -04:00
1. [From GitHub.com or GitHub Enterprise ](github.md )
2017-08-16 07:05:13 -04:00
1. [From GitLab.com ](gitlab_com.md )
1. [From Gitea ](gitea.md )
2017-08-29 06:56:59 -04:00
1. [From Perforce ](perforce.md )
2017-09-06 10:59:07 -04:00
1. [From SVN ](svn.md )
2019-08-12 03:36:32 -04:00
1. [From TFVC ](tfvc.md )
2018-02-20 21:23:49 -05:00
1. [From repo by URL ](repo_by_url.md )
2018-08-16 11:49:57 -04:00
1. [By uploading a manifest file (AOSP) ](manifest.md )
2019-05-05 11:26:15 -04:00
1. [From Gemnasium ](gemnasium.md )
2019-04-23 10:27:01 -04:00
1. [From Phabricator ](phabricator.md )
2020-04-15 11:09:17 -04:00
1. [From Jira (issues only) ](jira.md )
2017-08-16 07:05:13 -04:00
In addition to the specific migration documentation above, you can import any
Git repository via HTTP from the New Project page. Be aware that if the
repository is too large the import can timeout.
2019-07-08 04:50:38 -04:00
There is also the option of [connecting your external repository to get CI/CD benefits ](../../../ci/ci_cd_for_external_repos/index.md ). ** (PREMIUM)**
2019-05-05 11:26:15 -04:00
2020-03-03 22:08:50 -05:00
## Migrating from self-managed GitLab to GitLab.com
2017-08-16 07:05:13 -04:00
2020-03-01 22:07:58 -05:00
If you only need to migrate Git repos, you can [import each project by URL ](repo_by_url.md ). Issues and merge requests can't be imported.
2017-08-16 07:05:13 -04:00
If you want to retain all metadata like issues and merge requests, you can use
2020-03-03 22:08:50 -05:00
the [import/export feature ](../settings/import_export.md ) to export projects from self-managed GitLab and import those projects into GitLab.com.
2019-04-16 08:47:31 -04:00
2020-03-06 16:07:59 -05:00
All GitLab user associations (such as comment author) will be changed to the user importing the project. For more information, please see [the import notes ](../settings/import_export.md#important-notes ).
2019-04-16 08:47:31 -04:00
2020-03-03 22:08:50 -05:00
If you need to migrate all data over, you can leverage our [API ](../../../api/README.md ) to migrate from self-managed to GitLab.com.
The order of assets to migrate from a self-managed instance to GitLab.com is the following:
2019-04-16 08:47:31 -04:00
2020-03-06 16:07:59 -05:00
NOTE: **Note:**
2020-03-12 23:09:49 -04:00
When migrating to GitLab.com, users would need to be manually created unless [SCIM ](../../../user/group/saml_sso/scim_setup.md ) is going to be used. Creating users with the API is limited to self-managed instances as it requires administrator access.
2020-03-06 16:07:59 -05:00
2019-04-16 08:47:31 -04:00
1. [Groups ](../../../api/groups.md )
1. [Projects ](../../../api/projects.md )
1. [Project variables ](../../../api/project_level_variables.md )
Keep in mind the limitations of the [import/export feature ](../settings/import_export.md#exported-contents ).
You will still need to migrate your Container Registry over a series of
Docker pulls and pushes and re-run any CI pipelines to retrieve any build artifacts.
2019-01-25 06:48:51 -05:00
2020-03-03 22:08:50 -05:00
## Migrating between two self-managed GitLab instances
2019-01-25 06:48:51 -05:00
2020-02-20 04:09:13 -05:00
The best method for migrating from one GitLab instance to another,
2019-01-25 06:48:51 -05:00
perhaps from an old server to a new server for example, is to
2020-02-20 04:09:13 -05:00
[back up the instance ](../../../raketasks/backup_restore.md ),
2019-01-25 06:48:51 -05:00
then restore it on the new server.
2019-04-16 08:47:31 -04:00
2019-07-14 20:46:34 -04:00
In the event of merging two GitLab instances together (for example, both instances have existing data on them and one can't be wiped),
2020-03-03 22:08:50 -05:00
refer to the instructions in [Migrating from self-managed GitLab to GitLab.com ](#migrating-from-self-managed-gitlab-to-gitlabcom ).
2020-03-06 16:07:59 -05:00
Additionally, you can migrate users using the [Users API ](../../../api/users.md ) with an admin user.