# Move an existing collection to the new GitHub path

**URL:** <https://forum.ansible.com/t/move-an-existing-collection-to-the-new-github-path/44365>\
**Category:** Get Help\
**Tags:** collections\
**Created:** [August 25, 2025, 2:36am UTC](https://forum.ansible.com/t/move-an-existing-collection-to-the-new-github-path/44365 "2025-08-25T02:36:39Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![ieisystem](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/ieisystem/32/1263_2.png) [@ieisystem](https://forum.ansible.com/u/ieisystem)\
**Post date:** [August 25, 2025, 2:36am UTC](https://forum.ansible.com/t/move-an-existing-collection-to-the-new-github-path/44365/1 "2025-08-25T02:36:39Z")

</div>

I want to transfer a collection to a new GitHub address, but I don’t want to modify the content of the collection or change its name. Because this GitHub address is related to the set in [docs.ansible.com](http://docs.ansible.com), when I modify the GitHub address of the set, it will cause the association in [docs.ansible.com](http://docs.ansible.com) to become invalid. What should I do to ensure that the GitHub path in [docs.ansible.com](http://docs.ansible.com) can be modified simultaneously?

---

<div class="post-metadata">

**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\
**Post date:** [August 25, 2025, 4:24am UTC](https://forum.ansible.com/t/move-an-existing-collection-to-the-new-github-path/44365/2 "2025-08-25T04:24:09Z")

</div>

Generally changing the GitHub path (or even moving it to another hosting service) doesn’t matter, because Ansible Galaxy doesn’t use the path, it only allows you to provide it in galaxy.yml so the users can easily find it from the Galaxy UI. So updating the path in galaxy.yml (and docs/docsite/config.yml, if you use that config file) is enough. Once you do a new release, the paths on Galaxy will be updated.

But you’re apparently asking about **a collection included in the Ansible community package**. (The only collections shown on [docs.ansible.com](http://docs.ansible.com) are the collections included in the Ansible community package.) The Git repository URLs included in [docs.ansible.com](http://docs.ansible.com) are taken from galaxy.yml resp. docs/docsite/config.yml of the collection that’s included in the respective Ansible version. So once you create a new release of the collection, and a new Ansible release is made that includes that version, the URLs on [docs.ansible.com](http://docs.ansible.com) are updated.

Please note that the Git repository URLs of these collections are also tracked in [ansible-build-data/11/collection-meta.yaml at main · ansible-community/ansible-build-data · GitHub](https://github.com/ansible-community/ansible-build-data/blob/main/11/collection-meta.yaml) (for Ansible 11) and [ansible-build-data/12/collection-meta.yaml at main · ansible-community/ansible-build-data · GitHub](https://github.com/ansible-community/ansible-build-data/blob/main/12/collection-meta.yaml) (for Ansible 12) for the Ansible build. We would appreciate it if you could create a PR to update the paths in these two files, or alternatively create an issue in that repository informing us about the new path so we can update these files together with a new release of your collection.

(If there are no other changes in the collection, I’d do a bugfix release with release note “Maintenance release to update GitHub paths” or something like that.)

---

<div class="post-metadata">

**Author:** ![ieisystem](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/ieisystem/32/1263_2.png) [@ieisystem](https://forum.ansible.com/u/ieisystem)\
**Post date:** [August 25, 2025, 5:41am UTC](https://forum.ansible.com/t/move-an-existing-collection-to-the-new-github-path/44365/3 "2025-08-25T05:41:50Z")

</div>

Thank you very much for your reply.

---

<div class="post-metadata">

**Author:** ![mariolenz](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/mariolenz/32/108_2.png) [@mariolenz](https://forum.ansible.com/u/mariolenz)\
**Post date:** [August 25, 2025, 4:00pm UTC](https://forum.ansible.com/t/move-an-existing-collection-to-the-new-github-path/44365/4 "2025-08-25T16:00:58Z")

</div>

Just for your information, it looks like the Ansible community team at Red Hat is planning to [migrate docs.ansible.com to ansible.readthedocs.io](https://forum.ansible.com/t/43519).

This shouldn’t make any difference to you. Everything should work as @felixfontein explained. I just wanted to make you aware of this.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/ansible/original/1X/1882d9a01da5d8996a862359b0913cc568a39b84.svg) [@system](https://forum.ansible.com/u/system)\
**Post date:** [September 24, 2025, 4:01pm UTC](https://forum.ansible.com/t/move-an-existing-collection-to-the-new-github-path/44365/5 "2025-09-24T16:01:24Z")

</div>

Closed on September 24, 2025, 4:01pm UTC

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
