diff --git a/docs/source/conf.py b/docs/source/conf.py
index 5c9cc0e5..4dac2e4b 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -219,6 +219,7 @@ ogp_use_first_image = True
 # help us not break links.
 #
 rediraffe_branch = "main"
-rediraffe_redirects = {
+rediraffe_redirects = "redirects.txt"
+#rediraffe_redirects = {
     # "old-file": "new-folder/new-file-name",
-}
+#}
diff --git a/docs/source/redirects.txt b/docs/source/redirects.txt
new file mode 100644
index 00000000..b8cbd96c
--- /dev/null
+++ b/docs/source/redirects.txt
@@ -0,0 +1,8 @@
+"getting-started/faq.md" "faq/faq.md"
+"reference/api-only.md" "howto/api-only.md"
+"reference/config-ghoauth.md" "howto/configuration/config-ghoauth.md"
+"reference/config-proxy.md" "howto/configuration/config-proxy.md"
+"admin/log-messages.md" "howto/log-messages.md"
+"reference/proxy.md" "howto/proxy.md"
+"reference/templates.md" "howto/templates.md"
+"quickstart-docker.md" "tutorial/installation/quickstart-docker.md"