Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions docs/.vitepress/config.mts
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
2 changes: 1 addition & 1 deletion docs/builds/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
31 changes: 31 additions & 0 deletions docs/deployments/introduction.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: Introduction to Deployments
---

<ZoomableImage src="/docs/images/deployments/introduction/banner.webp" />

<br />

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)
Binary file not shown.