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