diff --git a/.gitea/workflows/mkdocs_build.yml b/.gitea/workflows/mkdocs_build.yml
index cddc040450..be4982a4e1 100644
--- a/.gitea/workflows/mkdocs_build.yml
+++ b/.gitea/workflows/mkdocs_build.yml
@@ -10,27 +10,22 @@ jobs:
   build-and-deploy:
     runs-on: ubuntu-latest-intranet
     steps:
-    - name: Checkout
-      uses: actions/checkout@v4
-    
-    - name: Mkdocs build
-      run: |
-        python3 -m venv mkdocs_venv
-        source mkdocs_venv/bin/activate
-        pip install -r requirements.txt      
-        mkdocs build -d public
-    
+    - uses: actions/checkout@v6
+
     - name: Configure Git
       run: |
         git config --global user.name "Gitea Actions"
         git config --global user.email "actions@gitea.local"
 
-    - name: Push to gitea-pages branch
+    - uses: actions/setup-python@v6
+      with:
+        python-version: "3.x"
+
+    - name: Install mkdocs-material
       run: |
-        git checkout --orphan gitea-pages
-        git reset --hard
-        ls -la
-        cp -r ./public/* .
-        git add .
-        git commit -m "Deploy site"
-        git push -f https://${{secrets.GITHUB_TOKEN}}@gitea.psi.ch/${{ github.repository }}.git gitea-pages
+        apt-get update
+        apt-get install -y pngquant
+        pip install -r requirements.txt
+
+    - name: Deploy documentation
+      run: mkdocs gh-deploy --force -b gitea-pages
diff --git a/docs/_css/extra.css b/docs/_css/extra.css
index dc6fa9e828..e7c17b1712 100644
--- a/docs/_css/extra.css
+++ b/docs/_css/extra.css
@@ -1,4 +1,7 @@
-.md-nav__source{display: none;}
+.md-nav__source {
+    display: none;
+}
+
 .md-nav--primary > .md-nav__list > .md-nav__item > .md-nav__link {
     font-weight: bold;
 }
@@ -156,4 +159,4 @@
 
 .html-viewer-controls button:hover {
     background: #fff;
-}
\ No newline at end of file
+}
diff --git a/mkdocs.yaml b/mkdocs.yaml
index a68cd82ee8..2d33ecbe3c 100644
--- a/mkdocs.yaml
+++ b/mkdocs.yaml
@@ -64,24 +64,22 @@ extra:
   social:
     - icon: fontawesome/brands/mastodon 
       link: https://fosstodon.org/@squidfunk
+  generator: false
 
 extra_javascript:
-  - _javascripts/katex.js
+  #- _javascripts/katex.js
   # https://cdnjs.com/libraries/KaTeX
   # unpkg is incredibly slow (17s to load the css file)
-  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.js
-  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/contrib/auto-render.min.js
-  - https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.16.105/pdf.min.js
+  #- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.js
+  #- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/contrib/auto-render.min.js
+  #- https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.16.105/pdf.min.js
   - _javascripts/pdf-viewer.js
   - _javascripts/html-viewer.js
 extra_css:
   # https://cdnjs.com/libraries/KaTeX
   # unpkg is incredibly slow (17s to load the css file)
-  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.css
+  #- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.css
   - _css/extra.css
 
 watch:
   - docs
-
-extra:
-  generator: false
\ No newline at end of file
diff --git a/requirements.txt b/requirements.txt
index 7fb3db4d52..8747b58b43 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,8 @@
-mkdocs
-mkdocs-autorefs
-mkdocs-material
-pymdown-extensions
-mkdocs-include-markdown-plugin
-mkdocs-pdf
\ No newline at end of file
+mkdocs-material[recommended]==9.7.*
+mkdocs-material[git]==9.7.*
+mkdocs-material[imaging]==9.7.*
+mkdocs-glightbox==0.5.*
+mkdocs-pdf==0.1.2
+mkdocs-autorefs==1.4.4
+mkdocs-include-markdown-plugin==7.2.*
+