dagshub-docs/docs/integration_guide/connect_a_git_server_to_dagshub.md

Mirror or Migrate a Git Server to DagsHub

If you have a project hosted on a Git provider (GitLab, BitBoucket, etc.) and want to enjoy the added value DagsHub offers, you can easily mirror or migrate the project to DagsHub and enjoy the best of both worlds!

Note: We have a tighter integration for Git servers hosted on GitHub. To learn more about it, please see the DagsHub Connect docs.

How DagsHub Mirror / Migrate git servers?

Mirror a Git server

When mirroring a remote Git server to DagsHub, behind the scenes, it clones all the commits and branches to the new DagsHub repository and displays them there. The original Git server stays the default Git remote while adding the unique DagsHub remotes (storage, experiment tracking, etc.) as an integral part of the project.

 _{Mirrored repository remotes}

The repository will be automatically synced every 24 hours or triggered manually by clicking on the sync button next to the project name. Behind the scenes, DagsHub pulls all the changes from the remote Git server and displays them.

 _{Sync button}

Migrate a Git server

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 use it?

How to mirror a Git server to DagsHub?

• From the Create menu, choose the "Connect a repo" option.

 _{Connect a repo}

• Choose the "Other" option on the Connection menu.

 _{Connect 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 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. Launch the Connection.

How to migrate a Git server to DagsHub?

• From the Create menu, choose the "Migrate a repo" option.

 _{Migrate a repo}

• Fill in the connection information:

 _{Migrate 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 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. Launch the Migration.