# Most links off of the docs.ansible.com site are currently 404ing

**URL:** <https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645>\
**Category:** Get Help\
**Created:** [October 8, 2025, 8:51pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645 "2025-10-08T20:51:44Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![andygeorge](https://avatars.discourse-cdn.com/v4/letter/a/e68b1a/32.png) [@andygeorge](https://forum.ansible.com/u/andygeorge)\
**Post date:** [October 8, 2025, 8:51pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/1 "2025-10-08T20:51:44Z")

</div>

This started to occur a few minutes ago; I had been reading docs before that.

---

<div class="post-metadata">

**Author:** ![Leo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/leo/32/23_2.png) [@Leo](https://forum.ansible.com/u/Leo)\
**Post date:** [October 8, 2025, 8:54pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/2 "2025-10-08T20:54:03Z")

</div>

The issue has been confirmed and we are notifying the proper teams and looking into it. Thanks!

ps. You also reported it in this thread: [We’re moving to Read The Docs](https://forum.ansible.com/t/we-re-moving-to-read-the-docs/43519)

I will let both comments in, as it might or might not be related and this one is in #Get Help, so it will get more visibility for those impacted.

---

<div class="post-metadata">

**Author:** ![bcoca](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/bcoca/32/9269_2.png) [@bcoca](https://forum.ansible.com/u/bcoca)\
**Post date:** [October 8, 2025, 8:54pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/3 "2025-10-08T20:54:13Z")

</div>

This is known and the team is rerunning the jobs that build the docs website.

---

<div class="post-metadata">

**Author:** ![bpendell](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/bpendell/32/8087_2.png) [@bpendell](https://forum.ansible.com/u/bpendell)\
**Post date:** [October 8, 2025, 9:06pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/4 "2025-10-08T21:06:44Z")

</div>

Thank you. What’s the story with [readthedocs.io](http://readthedocs.io)? I just got started with ansible in the last two months, and I was using docs from [docs.ansible.com](http://docs.ansible.com) without issue. When, today, I saw the entire latest directory in was empty, I came to this forum to see that you’re supposed to be moving to readthedocs – but that post was dated 2023, two years ago.

What happened? Clearly, docsansiblecom is still functional, and most of the links on this forum outside the one thread point there.

---

<div class="post-metadata">

**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\
**Post date:** [October 8, 2025, 10:09pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/5 "2025-10-08T22:09:29Z")

</div>

Sorry all. Fix is incoming. This only affects the latest version of the docs which are also the Ansible 12 docs which you can find here: [Ansible Documentation — Ansible Community Documentation](https://docs.ansible.com/ansible/12/index.html)

---

<div class="post-metadata">

**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\
**Post date:** [October 8, 2025, 10:10pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/6 "2025-10-08T22:10:54Z")

</div>

`docs.ansible.com` is the official home of the Ansible documentation. We’re planning to move the subdomain to Read The Docs hosting soon. It has just taken much longer than expected for a variety of reasons.

Edit for clarity

---

<div class="post-metadata">

**Author:** ![bpendell](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/bpendell/32/8087_2.png) [@bpendell](https://forum.ansible.com/u/bpendell)\
**Post date:** [October 20, 2025, 5:35pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/7 "2025-10-20T17:35:27Z")

</div>

I’m sorry, but as of 1:34PM Eastern on 20 Oct [docs.ansible.com/latest](http://docs.ansible.com/latest) is once again down. I assume the issue is already being worked; can we have an ETA for restoration of service?

This isn’t related to the ongoing AWS outage, by any chance?

---

<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:** [October 20, 2025, 6:06pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/8 "2025-10-20T18:06:27Z")

</div>

Are you looking for [Ansible Documentation — Ansible Community Documentation](https://docs.ansible.com/ansible/latest/) (`https://docs.ansible.com/ansible/latest/`)? I’m not sure whether the URL without `/ansible/` ever worked.

---

<div class="post-metadata">

**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\
**Post date:** [October 20, 2025, 6:09pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/9 "2025-10-20T18:09:22Z")

</div>

The latest version of the docs kept getting nuked but they should be back now. @bpendell apologies for the inconvenience that caused and thank you for reporting it.

---

<div class="post-metadata">

**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\
**Post date:** [October 20, 2025, 6:21pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/10 "2025-10-20T18:21:09Z")

</div>

Here is an explanation:

- Docs are on the web server at `/var/www/html/docs/ansible` and the `latest` subdirectory is actually a symlink to whatever the corresponding version is. Right now that is `/var/www/html/docs/ansible/12`. This gets created during the build with `ln -s 12 latest`.
- There was a change in the `ansible/docsite` repo to change the `ansible/<version>/.htaccess` file to `ansible/latest/.htaccess` when we released version 12. This was my idea. It turned out to be a bad one (sorry).
- As a result the symlink was getting replaced by `latest/.htaccess`. This effectively turned the `latest` subdirectory into an empty folder on the hosts.

Here’s a link to the fix: [Fix latest by oraNod · Pull Request #291 · ansible/docsite · GitHub](https://github.com/ansible/docsite/pull/291)

---

<div class="post-metadata">

**Author:** ![bpendell](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/bpendell/32/8087_2.png) [@bpendell](https://forum.ansible.com/u/bpendell)\
**Post date:** [October 20, 2025, 6:41pm UTC](https://forum.ansible.com/t/most-links-off-of-the-docs-ansible-com-site-are-currently-404ing/44645/11 "2025-10-20T18:41:41Z")

</div>

Thank you , yes, it appears to be working now. Kudos for the quick response!

Respectfully,

Brian P.
