diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 6b2d9469d..c7a2f521c 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -9,6 +9,10 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.12"
-    
+
+python:
+  install:
+    - requirements: ./mkdocs/requirements.txt
+
 mkdocs:
-  configuration: mkdocs.yml
+  configuration: ./mkdocs/mkdocs.yml
diff --git a/mkdocs.yml b/mkdocs/mkdocs.yml
similarity index 99%
rename from mkdocs.yml
rename to mkdocs/mkdocs.yml
index 87242935e..c81426bf0 100644
--- a/mkdocs.yml
+++ b/mkdocs/mkdocs.yml
@@ -8,6 +8,7 @@ edit_uri: blob/main/docs/
 # Repository
 repo_name: GeotrekCE/Geotrek-rando-v3/
 repo_url: https://github.com/GeotrekCE/Geotrek-rando-v3/
+docs_dir: ../docs 
 
 # Configuration
 theme:
diff --git a/mkdocs/requirements.txt b/mkdocs/requirements.txt
new file mode 100644
index 000000000..40bf9a9b5
--- /dev/null
+++ b/mkdocs/requirements.txt
@@ -0,0 +1,35 @@
+# Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to
+# deal in the Software without restriction, including without limitation the
+# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+# sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+# IN THE SOFTWARE.
+
+# Requirements for core
+jinja2~=3.0
+markdown~=3.2
+mkdocs~=1.6
+mkdocs-material~=9.5.39
+mkdocs-material-extensions~=1.3
+pygments~=2.16
+pymdown-extensions~=10.2
+
+# Requirements for plugins
+babel~=2.10
+colorama~=0.4
+paginate~=0.5
+regex>=2022.4
+requests~=2.26