ContextQMD
Back to Gitlabhq

Migrate from FogBugz

doc/user/project/import/fogbugz.md

18.11.22.7 KB
Original Source

{{< details >}}

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

  • Ability to re-import projects introduced in GitLab 15.9.

{{< /history >}}

Using the importer, you can import your FogBugz project to GitLab.com or to GitLab Self-Managed.

The importer imports all of your cases and comments with the original case numbers and timestamps. You can also map FogBugz users to GitLab users.

Prerequisites

{{< history >}}

  • Requirement for Maintainer role instead of Developer role introduced in GitLab 16.0 and backported to GitLab 15.11.1 and GitLab 15.10.5.

{{< /history >}}

  • FogBugz import source must be enabled. If not enabled, ask your GitLab administrator to enable it. The FogBugz import source is enabled by default on GitLab.com.
  • The Maintainer or Owner role on the destination group to import to.

Import project from FogBugz

To import your project from FogBugz:

  1. Sign in to GitLab.
  2. In the upper-right corner, select Create new ({{< icon name="plus" >}}) and New project/repository.
  3. Select Import project.
  4. Select FogBugz.
  5. Enter your FogBugz URL, email address, and password.
  6. Create a mapping from FogBugz users to GitLab users. For each FogBugz user:
    • To map a FogBugz account to a full name, without mapping it to a GitLab account, leave the GitLab User text box empty. This mapping adds the user's full name to the description of all issues and comments, but assigns the issues and comments to the project creator.
    • To map a FogBugz account to a GitLab account, in GitLab User, select the GitLab user you want to associate issues and comments with.
  7. When all users are mapped, select Continue to the next step.
  8. For each project you want to import, select Import.
  9. After the import finishes, select the link to go to the project dashboard. Follow the directions to push your existing repository.
  10. To import a project:
    • For the first time: Select Import.
    • Again: Select Re-import. Specify a new name and select Re-import again. Re-importing creates a new copy of the source project.