diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index f812ee39..57e84c96 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -2,10 +2,20 @@ name: docs
 on: [push, pull_request]
 
 permissions:
-  contents: write
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
 
 jobs:
   deploy:
+    enviroment:
+        name: documenation
+        url: ${{steps.deployement.outputs.page_url}}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -40,3 +50,12 @@ jobs:
       - run: uv run mkdocs build --config-file config/mkdocs.yml
 
       - run: uv run mkdocs gh-deploy --force --config-file config/mkdocs.yml
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+            # Upload entire repository
+            path: 'site/'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4