Mirror Summary

[lunny]

• Mirror issues along with the repo Mirror issues along with the repo #1876
• Mirror new-created wiki when repositories migrated Github Mirrors and Wiki #2309
• Reverse mirroring, from Gitea to remote Github/Gitlab/Gitea and etc. Ability to automatically push to remote mirror repository  #3480
• Mirror repositories could not be readonly and Allow to push commits manually Cannot push to my repo (mirror is readonly) #7609
• Mirror an entire github organization into gitea organization Proposal: Mirror an entire github organization into gitea organization #8424
• Mirror Topics Mirror projects: How resync missing Topics? #14590
• Mirror Docs

[c4lliope]

I searched for "Mirror" on https://docs.gitea.io, and I didn't see much describing how mirrors run;
e.g. what happens automatically (git pull, git prune from the origin codebase?)
and what must be updated by a manual process (issues, wiki pages).

Someone visiting gitea.com as an end user will probably need a summary page
of the purpose and mechanisms of mirror repositories.
Maybe a paragraph on the "import repository" page could help people learn more.

[kdumontnu]

Is #3480 a duplicate issue to #7609?

[lunny]

@kdumontnu I think it's not the same. #3480 means a reverse mirror, #7609 means a mirror repository could be not readonly.

[lunny]

I searched for "Mirror" on https://docs.gitea.io, and I didn't see much describing how mirrors run;
e.g. what happens automatically (git pull, git prune from the origin codebase?)
and what must be updated by a manual process (issues, wiki pages).

Someone visiting gitea.com as an end user will probably need a summary page
of the purpose and mechanisms of mirror repositories.
Maybe a paragraph on the "import repository" page could help people learn more.

Yes, mirror docs is also needed.

[kdumontnu]

@lunny thx, but the syntax is very confusing then. You say "Reverse mirroring #7609" above, but "#3480 means reverse mirror".

Do you mean then: "Enable pushing to Gitea repo configured as secondary mirror #7609"?
And "Enable Gitea as primary in mirror configuration #3480"?

We can use consistent diction for mirrors as "primary (push)" and "secondary (pull)"

---

Also, I added a bounty to #3480 if you can add the following:

[![Bountysource](https://api.bountysource.com/badge/issue?issue_id=54827645)](https://www.bountysource.com/issues/54827645-ability-to-automatically-push-to-remote-mirror-repository)

• Enable Gitea as primary in mirror configuration Ability to automatically push to remote mirror repository  #3480

[lunny]

@lunny thx, but the syntax is very confusing then. You say "Reverse mirroring #7609" above, but "#3480 means reverse mirror".

Do you mean then: "Enable pushing to Gitea repo configured as secondary mirror #7609"?
And "Enable Gitea as primary in mirror configuration #3480"?

We can use consistent diction for mirrors as "primary (push)" and "secondary (pull)"

Also, I added a bounty to #3480 if you can add the following:

[![Bountysource](https://api.bountysource.com/badge/issue?issue_id=54827645)](https://www.bountysource.com/issues/54827645-ability-to-automatically-push-to-remote-mirror-repository)

• Enable Gitea as primary in mirror configuration Ability to automatically push to remote mirror repository  #3480

Thanks, I have updated the issue content. I haven't followed your advise because I think primary and secondary is still confusing. Please let me know if you think it's still confusing. :)

[6543]

Option to "protect" mirrors (dont sync if it will drop commits or is a completly new history)

[Sirttas]

I would suggest in addition to the issue #3480 to add the ability to only push certain branch, tags, etc.

[culmat]

see also #18220