diff --git a/.changeset/purple-rice-suffer.md b/.changeset/purple-rice-suffer.md
new file mode 100644
index 00000000..31d23f6d
--- /dev/null
+++ b/.changeset/purple-rice-suffer.md
@@ -0,0 +1,5 @@
+---
+'@lagoss/ui': minor
+---
+
+Updated docs to vitepress, added self-hosting instructions and adjusted README
diff --git a/packages/docs/.vitepress/config.ts b/packages/docs/.vitepress/config.ts
index a40b629a..abaa25e0 100644
--- a/packages/docs/.vitepress/config.ts
+++ b/packages/docs/.vitepress/config.ts
@@ -57,6 +57,15 @@ export default defineConfig({
           // { text: 'Regions', link: '/usage/regions' },
           { text: 'Limits', link: '/usage/limits' },
           { text: 'Security', link: '/usage/security' },
+          {
+            text: 'CI',
+            collapsed: true,
+            items: [
+              { text: 'Github Actions', link: '/ci/github-actions' },
+              { text: 'Gitlab CI', link: '/ci/gitlab-ci' },
+              { text: 'Woodpecker', link: '/ci/woodpecker' },
+            ],
+          },
         ],
       },
       {
diff --git a/packages/docs/content/ci/github-actions.md b/packages/docs/content/ci/github-actions.md
new file mode 100644
index 00000000..59b415f1
--- /dev/null
+++ b/packages/docs/content/ci/github-actions.md
@@ -0,0 +1,5 @@
+# Deploy using Github Actions
+
+https://github.com/lagossapp/github-action/tree/latest
+
+Work in progress ...
diff --git a/packages/docs/content/ci/gitlab-ci.md b/packages/docs/content/ci/gitlab-ci.md
new file mode 100644
index 00000000..1c153d42
--- /dev/null
+++ b/packages/docs/content/ci/gitlab-ci.md
@@ -0,0 +1,3 @@
+# Deploy using Gitlab CI
+
+Work in progress ...
diff --git a/packages/docs/content/ci/index.md b/packages/docs/content/ci/index.md
new file mode 100644
index 00000000..5636ad1f
--- /dev/null
+++ b/packages/docs/content/ci/index.md
@@ -0,0 +1,9 @@
+# Automatic deployment using CI
+
+You can use your existing CI system to automatically deploy your project to lagoss.
+
+Currently following CI systems are supported, but most other systems should work by using the [@lagoss/cli](../cli.md):
+
+- [Github actions](github-actions.md)
+- [Gitlab CI](gitlab-ci.md)
+- [Woodpecker CI](woodpecker.md)
diff --git a/packages/docs/content/ci/woodpecker.md b/packages/docs/content/ci/woodpecker.md
new file mode 100644
index 00000000..98ea961b
--- /dev/null
+++ b/packages/docs/content/ci/woodpecker.md
@@ -0,0 +1,3 @@
+# Deploy using Woodpecker CI
+
+Work in progress ...