Skip to content

Latest commit

 

History

History
125 lines (87 loc) · 4.31 KB

duplicating-a-repository.md

File metadata and controls

125 lines (87 loc) · 4.31 KB
Raw
title intro redirect_from versions topics
Duplicating a repository
To maintain a mirror of a repository without forking it, you can run a special clone command, then mirror-push to the new repository.
/articles/duplicating-a-repo
/articles/duplicating-a-repository
/github/creating-cloning-and-archiving-repositories/duplicating-a-repository
/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/duplicating-a-repository
fpt ghes ghec
*
*
*
Repositories

{% ifversion fpt or ghec %}

{% note %}

Note: If you have a project hosted on another Git-based hosting service, you can automatically import your project to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_importer %} tool. For more information, see "AUTOTITLE."

{% endnote %}

{% endif %}

Before you can push the original repository to your new copy, or mirror, of the repository, you must create the new repository on {% data variables.location.product_location %}. In these examples, exampleuser/new-repository or exampleuser/mirrored are the mirrors.

Mirroring a repository

{% data reusables.command_line.open_the_multi_os_terminal %}

  1. Create a bare clone of the repository.

    git clone --bare https://{% data variables.product.product_url %}/EXAMPLE-USER/OLD-REPOSITORY.git

  2. Mirror-push to the new repository.

    cd OLD-REPOSITORY.git
git push --mirror https://{% data variables.product.product_url %}/EXAMPLE-USER/NEW-REPOSITORY.git

  3. Remove the temporary local repository you created earlier.

    cd ..
rm -rf OLD-REPOSITORY.git

Mirroring a repository that contains {% data variables.large_files.product_name_long %} objects

{% data reusables.command_line.open_the_multi_os_terminal %}

  1. Create a bare clone of the repository. Replace the example username with the name of the person or organization who owns the repository, and replace the example repository name with the name of the repository you'd like to duplicate.

    git clone --bare https://{% data variables.product.product_url %}/EXAMPLE-USER/OLD-REPOSITORY.git

  2. Navigate to the repository you just cloned.

    cd OLD-REPOSITORY.git

  3. Pull in the repository's {% data variables.large_files.product_name_long %} objects.

    git lfs fetch --all

  4. Mirror-push to the new repository.

    git push --mirror https://{% data variables.product.product_url %}/EXAMPLE-USER/NEW-REPOSITORY.git

  5. Push the repository's {% data variables.large_files.product_name_long %} objects to your mirror.

    git lfs push --all https://github.com/EXAMPLE-USER/NEW-REPOSITORY.git

  6. Remove the temporary local repository you created earlier.

    cd ..
rm -rf OLD-REPOSITORY.git

Mirroring a repository in another location

If you want to mirror a repository in another location, including getting updates from the original, you can clone a mirror and periodically push the changes.

{% data reusables.command_line.open_the_multi_os_terminal %}

  1. Create a bare mirrored clone of the repository.

    git clone --mirror https://{% data variables.product.product_url %}/EXAMPLE-USER/REPOSITORY-TO-MIRROR.git

  2. Set the push location to your mirror.

    cd REPOSITORY-TO-MIRROR
git remote set-url --push origin https://{% data variables.product.product_url %}/EXAMPLE-USER/MIRRORED

    As with a bare clone, a mirrored clone includes all remote branches and tags, but all local references will be overwritten each time you fetch, so it will always be the same as the original repository. Setting the URL for pushes simplifies pushing to your mirror.

  3. To update your mirror, fetch updates and push.

    git fetch -p origin
git push --mirror

{% ifversion fpt or ghec %}

Further reading

{% endif %}