diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
new file mode 100644
index 00000000000..874a3f77c6c
--- /dev/null
+++ b/.github/workflows/deploy-docs.yml
@@ -0,0 +1,40 @@
+name: Deploy docs
+# This job builds and deploys documenation to github pages.
+# It runs on every push to main with a change in the docs folder.
+on:
+  push:
+    branches:
+      - main
+      - "release/**"
+    paths:
+      - "docs/**"
+      - .github/workflows/deploy-docs.yml
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-deploy:
+    permissions:
+      contents: write # for JamesIves/github-pages-deploy-action to push changes in repo
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/cosmos/website-deployment
+    steps:
+      - name: Checkout 🛎️
+        uses: actions/checkout@v3
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+          path: "."
+
+      - name: Build 🔧
+        run: |
+          make build-docs LEDGER_ENABLED=false
+
+      - name: Deploy 🚀
+        uses: JamesIves/github-pages-deploy-action@v4.4.0
+        with:
+          branch: gh-pages
+          folder: ~/output
+          single-commit: true