diff --git a/docs/images/docker-readarr.md b/docs/deprecated_images/docker-readarr.md
similarity index 85%
rename from docs/images/docker-readarr.md
rename to docs/deprecated_images/docker-readarr.md
index c10822607..b52a6a759 100644
--- a/docs/images/docker-readarr.md
+++ b/docs/deprecated_images/docker-readarr.md
@@ -6,6 +6,13 @@ description: "[Readarr](https://github.com/Readarr/Readarr) - Book Manager and A
 ---
 <!-- DO NOT EDIT THIS FILE MANUALLY -->
 <!-- Please read https://github.com/linuxserver/docker-readarr/blob/develop/.github/CONTRIBUTING.md -->
+
+# DEPRECATION NOTICE 
+
+This image is deprecated. We will not offer support for this image and it will not be updated.
+
+Due to lack of developers, and issues with maintaining status quo, upstream has decided to retire the project.
+
 # [linuxserver/readarr](https://github.com/linuxserver/docker-readarr)
 
 [![Scarf.io pulls](https://scarf.sh/installs-badge/linuxserver-ci/linuxserver%2Freadarr?color=94398d&label-color=555555&logo-color=ffffff&style=for-the-badge&package-type=docker)](https://scarf.sh)
@@ -53,7 +60,7 @@ Access the webui at `<your-ip>:8787`, for more information check out [Readarr](h
 
 ### Media folders
 
-We have set '/books' and '/downloads' as optional paths, this is because it is the easiest way to get started. While easy to use, it has some drawbacks. Mainly losing the ability to hardlink (TL;DR a way for a file to exist in multiple places on the same file system while only consuming one file worth of space), or atomic move (TL;DR instant file moves, rather than copy+delete) files while processing content.
+We have set `/books` and `/downloads` as optional paths, this is because it is the easiest way to get started. While easy to use, it has some drawbacks. Mainly losing the ability to hardlink (TL;DR a way for a file to exist in multiple places on the same file system while only consuming one file worth of space), or atomic move (TL;DR instant file moves, rather than copy+delete) files while processing content.
 
 Use the optional paths if you don't understand, or don't want hardlinks/atomic moves.
 
@@ -307,3 +314,64 @@ docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
 ```
 
 Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64`.
+
+To help with development, we generate this dependency graph.
+
+??? info "Init dependency graph"
+
+    ```d2
+    "readarr:develop": {
+      docker-mods
+      base {
+        fix-attr +\nlegacy cont-init
+      }
+      docker-mods -> base
+      legacy-services
+      custom services
+      init-services -> legacy-services
+      init-services -> custom services
+      custom services -> legacy-services
+      legacy-services -> ci-service-check
+      init-migrations -> init-adduser
+      init-os-end -> init-config
+      init-config -> init-config-end
+      init-crontab-config -> init-config-end
+      init-readarr-config -> init-config-end
+      init-config -> init-crontab-config
+      init-mods-end -> init-custom-files
+      init-adduser -> init-device-perms
+      base -> init-envfile
+      base -> init-migrations
+      init-config-end -> init-mods
+      init-mods-package-install -> init-mods-end
+      init-mods -> init-mods-package-install
+      init-adduser -> init-os-end
+      init-device-perms -> init-os-end
+      init-envfile -> init-os-end
+      init-config -> init-readarr-config
+      init-custom-files -> init-services
+      init-services -> svc-cron
+      svc-cron -> legacy-services
+      init-services -> svc-readarr
+      svc-readarr -> legacy-services
+    }
+    Base Images: {
+      "baseimage-alpine:3.21"
+    }
+    "readarr:develop" <- Base Images
+    ```
+
+## Versions
+
+* **27.06.25:** - Deprecate image.
+* **20.12.24:** - Rebase to Alpine 3.21.
+* **25.05.24:** - Rebase to Alpine 3.20.
+* **20.03.24:** - Rebase to Alpine 3.19.
+* **06.06.23:** - Rebase develop to Alpine 3.18.
+* **19.12.22:** - Rebase develop branch to Alpine 3.17, migrate to s6v3.
+* **21.02.22:** - Add develop branch.
+* **04.02.22:** - Rebase nightly branch to Alpine.
+* **21.01.22:** - Remove chromaprint as it's no longer a required dependency.
+* **01.01.22:** - Add chromaprint for audio fingerprinting.
+* **30.12.21:** - Add nightly-alpine branch.
+* **28.07.21:** - Initial Release.
diff --git a/mkdocs.yml b/mkdocs.yml
index 744e74998..341ad8224 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -126,3 +126,4 @@ plugins:
         general/fleet.md: API.md
         images/docker-emulatorjs.md: deprecated_images/docker-emulatorjs.md
         images/docker-netbootxyz.md: deprecated_images/docker-netbootxyz.md
+        images/docker-readarr.md: deprecated_images/docker-readarr.md