diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 11f31a41..cc2db74a 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -147,6 +147,59 @@ export default defineConfig({
{ text: 'Build Servers', link: '/builds/servers' },
],
},
+ {
+ text: 'Deployments',
+ collapsed: true,
+ items: [
+ { text: 'Introduction', link: '/deployments/introduction' },
+ { text: 'Automatic Deployments', link: '/deployments/introduction' },
+ { text: 'Preview Deployments', link: '/deployments/introduction' },
+ { text: 'Git-based Deployments', link: '/deployments/introduction' },
+ { text: 'Docker-based Deployments', link: '/deployments/introduction' },
+ { text: 'Multi-Server Deployments', link: '/deployments/introduction' },
+ {
+ text: 'One Click Deployments',
+ collapsed: true,
+ items: [
+ {
+ text: 'Databases',
+ collapsed: true,
+ items: [
+ { text: 'PostgreSQL', link: '/builds/packs/overview' },
+ { text: 'MySQL', link: '/builds/packs/static' },
+ { text: 'Redis', link: '/builds/packs/nixpacks' },
+ { text: 'Dragonfly', link: '/builds/packs/dockerfile' },
+ { text: 'Clickhouse', link: '/builds/packs/docker-compose' },
+ ]
+ },
+ {
+ text: 'Services',
+ collapsed: true,
+ items: [
+ { text: 'A', link: '/builds/packs/overview' },
+ { text: 'B', link: '/builds/packs/static' },
+ { text: 'C', link: '/builds/packs/nixpacks' },
+ { text: 'D', link: '/builds/packs/dockerfile' },
+ { text: 'E', link: '/builds/packs/docker-compose' },
+ ]
+ },
+ ]
+ },
+ { text: 'Rollbacks', link: '/deployments/introduction' },
+ { text: 'Presistent Storages', link: '/deployments/introduction' },
+ { text: 'Custom Domains', link: '/deployments/introduction' },
+ {
+ text: 'SSL Certificates',
+ collapsed: true,
+ items: [
+ { text: 'Lets Encrypt', link: '/builds/packs/overview' },
+ { text: 'Cloudflare', link: '/builds/packs/static' },
+ { text: 'Hetzner', link: '/builds/packs/nixpacks' },
+ ]
+ },
+ { text: 'DNS Configuration', link: '/deployments/introduction' },
+ ],
+ },
{
text: 'Applications',
collapsed: true,
diff --git a/docs/builds/introduction.md b/docs/builds/introduction.md
index 61b25b85..93fd5266 100644
--- a/docs/builds/introduction.md
+++ b/docs/builds/introduction.md
@@ -39,4 +39,4 @@ Once the images are pushed, you can easily use them on Coolify.
## What's Next?
-Check the pages in the sidebar to learn more about build packs, build commands, and build servers.
+Check the pages in the sidebar to learn more about build packs, build commands, and build servers.
\ No newline at end of file
diff --git a/docs/deployments/introduction.md b/docs/deployments/introduction.md
new file mode 100644
index 00000000..9b67cdb2
--- /dev/null
+++ b/docs/deployments/introduction.md
@@ -0,0 +1,31 @@
+---
+title: Introduction to Deployments
+---
+
+
+
+
+
+A deployment is the process of releasing a specific version of your application (packaged as a Docker container) to one or more environments. Coolify makes it easy to push updates, preview changes before they go live, and ensure your users never experience downtime.
+
+## How Deployments Work
+- **Container Registry:** Every deployment pulls a Docker image—either built by Coolify or pre–built and pushed to a registry (e.g., Docker Hub, GitHub Container Registry).
+- **Deployment Configuration:** You define which image tag to deploy and any runtime settings (environment variables, ports, volumes, secrets).
+- **Release Strategy:** Coolify supports multiple deployment strategies to match your needs:
+ - **Rolling Updates:** Gradually replace old containers with new ones to maintain availability.
+ - **Instant Rollback:** If something goes wrong, revert to the previous version with a single click.
+
+
+## Preview Deployments
+- **On‑Demand Previews:** Spin up a temporary environment for each pull request or branch, complete with its own URL.
+- **Automatic Cleanup:** Preview deployments are automatically torn down when the branch is closed or merged.
+
+
+## Zero‑Downtime Deployments
+- **Health Checks & Readiness Probes:** Coolify waits for new containers to pass health checks before routing traffic.
+- **Graceful Shutdown:** Old containers are drained of active connections before being terminated.
+
+## What’s Next?
+Explore the pages in the sidebar to learn more about:
+- [Preview Deployments ↗](/deployments/previews)
+- [Rollbacks ↗](/deployments/rollbacks)
diff --git a/docs/public/images/deployments/introduction/banner.webp b/docs/public/images/deployments/introduction/banner.webp
new file mode 100644
index 00000000..a6057384
Binary files /dev/null and b/docs/public/images/deployments/introduction/banner.webp differ