debian-mirror-gitlab/doc/user/project/import/fogbugz.md

---
type: reference, howto
stage: Manage
group: Import
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
---

# Import your project from FogBugz to GitLab

It only takes a few simple steps to import your project from FogBugz.
The importer will import all of your cases and comments with original case
numbers and timestamps. You will also have the opportunity to map FogBugz
users to GitLab users.

1. From your GitLab dashboard click 'New project'
1. Click on the 'FogBugz' button

  ![FogBugz](img/fogbugz_import_select_fogbogz.png)

1. Enter your FogBugz URL, email address, and password.

  ![Login](img/fogbugz_import_login.png)

1. Create mapping from FogBugz users to GitLab users.

  ![User Map](img/fogbugz_import_user_map.png)

1. Select the projects you wish to import by clicking the Import buttons

  ![Import Project](img/fogbugz_import_select_project.png)

1. Once the import has finished click the link to take you to the project
   dashboard. Follow the directions to push your existing repository.

  ![Finished](img/fogbugz_import_finished.png)