dagshub-docs/docs/use_cases/connect_existing_project.md

Connect an existing project to DagsHub

Whether your project is hosted on GitHub, GitLab, BitBucket, or any other Git provider, this guide will walk you through the process of connecting your project to DagsHub. By connecting your project to DagsHub, you'll gain access to data hosting and versioning, experiment tracking, model registry, data annotations, and collaboration capabilities, designed specifically for machine learning projects.

How to connect projects from GitHub to DagsHub

If you have a GitHub project ready to connect, you can get started in less than a minute!

1. Press the blue Create + button on the top right and click + New Repository
2. Select the Import Repository card
3. Click on the GitHub Connect button and authorize in GitHub
4. Click the Add/Revoke Access button and choose to give access to all your repositories or specific ones.
5. Click the repository you want to connect on DagsHub and click Connect Repository.

_{DagsHub connect}

How to connect or migrate a Git server to DagsHub

If your project is hosted on GitLab, BitBucket, or any other Git provider you can connect of migrate it to DagsHub. The migration process is identical to the connection but assumes you want to move the project's development entirely to DagsHub. Therefore, it will create a new Git remote server for the project and clone all the files from the original Git server to it.

How to mirror a Git server to DagsHub?

• Click the Create + button and choose the + New Repository option.

[{: style="height:40%;width:40%"}](../integration_guide/assets/connect-1a.png){target=_blank}

• Select the Import Repository card.

 _{Mirror a repo}

• Choose the Other option on the Connection menu.

 _{Mirror a repo}

• Fill in the connection information:

 _{Connect a repo}

1. The Git server address - can be an HTTP/HTTPS/GIT URL.
2. If it requires authorization to access the Git server, please add the user name and authentication token (or password) needed to access it.
3. The new DagsHub repository settings:
   • The repository owner (mandatory) - can be a user or an organization.
   • The repository name (mandatory).
   • Visibility (optional).
   • Description (optional).
4. Select Mirror under Connectivity Mode.
5. Launch the Connection.

How to migrate a Git server to DagsHub?

Follow the same steps as above, but select Migrate under Connectivity Mode.

 _{Migrate a repo}

If you need to mirror or migrate a Git server not hosted on GitHub, follow this guide.