How to create a *mirror* repo on GitHub.com

[typed-sigterm]

Select Topic Area

Question

Body

I can't find any further information about the Public mirror badge.

Warning

Don't tell me to use git push --mirror. It never adds a badge.

[Raish0009]

mirror repo

[typed-sigterm]

how to?

[Raish0009]

Creating a mirror repository on GitHub means making an exact copy of another Git repository (including all branches, tags, and history). Here’s a step-by-step guide to do it:

---

Step 1: Clone the Source Repo as a Bare Repository

A bare clone is used to mirror everything without working files.

git clone --bare https://github.com/source-owner/source-repo.git

This will create a folder like source-repo.git in your local system.

---

Step 2: Create a New Empty Repo on GitHub

1. Go to https://github.com/new
2. Create a new repository (e.g., target-repo) under your account
3. Do not initialize it with README, .gitignore, or license

---

Step 3: Push the Mirror to the New GitHub Repo

cd source-repo.git
git push --mirror https://github.com/your-username/target-repo.git

This pushes all branches, tags, and refs to your new repository.

---

Step 4 (Optional): Delete Local Bare Repo

cd ..
rm -rf source-repo.git

---

Result

You now have an exact mirror of the original repository under your GitHub account. All branches and tags are preserved.

---

To Update the Mirror Later

If you want to update the mirror later (e.g., sync changes again):

cd source-repo.git
git fetch -p origin
git push --mirror https://github.com/your-username/target-repo.git

[wilfried-djoum]

To send a mirror of your repo to another do this,
on your computer do this: git clone --mirror https://github.com/your-org/repo-private.git
then: you will have a folder like : repo-private.git
then in this new foder, add the new remote : git remote add new https://github.com/new/new-repo.git

and now you can add the changes if necessary and push git push --mirror new

[JBurrell999]

If you want to mirror a repo, have your repo

git remote add github https://github.com/your-username/your-repo.git

git push --mirror github

Let me know if this helps at all.

[typed-sigterm]

it does not add mirror badge to github repo

[github-actions[bot]]

🕒 Discussion Activity Reminder 🕒

This Discussion has been labeled as dormant by an automated system for having no activity in the last 60 days. Please consider one the following actions:

1️⃣ Close as Out of Date: If the topic is no longer relevant, close the Discussion as out of date at the bottom of the page.

2️⃣ Provide More Information: Share additional details or context — or let the community know if you've found a solution on your own.

3️⃣ Mark a Reply as Answer: If your question has been answered by a reply, mark the most helpful reply as the solution.

Note: This dormant notification will only apply to Discussions with the Question label. To learn more, see our recent announcement.

Thank you for helping bring this Discussion to a resolution! 💬

[Tanishq-S-Dev05]

built-in option for the “Public mirror” badge (that label is usually applied internally by GitHub for projects like Chromium).

Here’s how you can mirror a repo yourself:

Create a new empty repo on GitHub (no README, .gitignore, or license).

Clone the upstream repo as a mirror:

git clone --mirror https://original-repo-url.git
cd repo-name.git

Push it to your GitHub repo:

git remote set-url --push origin https://github.com/your-username/your-repo.git
git push --mirror

To update the mirror in future:

git fetch -p origin
git push --mirror

👉 The “Public mirror” badge you see on some repos isn’t user-controlled, it’s applied by GitHub itself. You can still maintain your own synced mirror using the above steps, even though it won’t show that badge.

[github-actions[bot]]

🕒 Discussion Activity Reminder 🕒

This Discussion has been labeled as dormant by an automated system for having no activity in the last 60 days. Please consider one the following actions:

1️⃣ Close as Out of Date: If the topic is no longer relevant, close the Discussion as out of date at the bottom of the page.

2️⃣ Provide More Information: Share additional details or context — or let the community know if you've found a solution on your own.

3️⃣ Mark a Reply as Answer: If your question has been answered by a reply, mark the most helpful reply as the solution.

Note: This dormant notification will only apply to Discussions with the Question label. To learn more, see our recent announcement.

Thank you for helping bring this Discussion to a resolution! 💬

[github-actions[bot]]

🕒 Discussion Activity Reminder 🕒

This Discussion has been labeled as dormant by an automated system for having no activity in the last 60 days. Please consider one the following actions:

1️⃣ Close as Out of Date: If the topic is no longer relevant, close the Discussion as out of date at the bottom of the page.

2️⃣ Provide More Information: Share additional details or context — or let the community know if you've found a solution on your own.

3️⃣ Mark a Reply as Answer: If your question has been answered by a reply, mark the most helpful reply as the solution.

Note: This dormant notification will only apply to Discussions with the Question label. To learn more, see our recent announcement.

Thank you for helping bring this Discussion to a resolution! 💬

[typed-sigterm]

no

[wilfried-djoum]

To send a mirror of your repo to another do this,
on your computer do this: git clone --mirror https://github.com/your-org/repo-private.git
then: you will have a folder like : repo-private.git
then in this new foder, add the new remote : git remote add new https://github.com/new/new-repo.git

and now you can add the changes if necessary and push git push --mirror new

[typed-sigterm]

it does not add mirror badge to github repo