JK Docs
DevOps

Coolify Auto-Deploy from GitHub (CI/CD Setup)

Last updated: 4/20/2026

Two Integration Methods

Method 1: GitHub App (Recommended)

If Coolify is connected via a GitHub App, auto-deploy works automatically.

To enable Auto Deploy:

  1. Application → Advanced tab
  2. Enable the Auto Deploy toggle

Every git push to the configured branch triggers a deployment automatically.

Method 2: Manual Webhook

  1. Coolify → application → Webhooks tab, copy the Webhook URL
  2. GitHub: repository → Settings → Webhooks → Add webhook
  3. Paste the URL, Content-Type: application/json, select "push event"

Granting Repository Access (GitHub App method)

If a repository doesn't appear in Coolify's dropdown:

  1. GitHub → Profile → Settings → Integrations → GitHub Apps
  2. Find your Coolify app → Configure
  3. Under Repository access, add the specific repository
  4. Save

What Happens on Each Push

  1. GitHub notifies Coolify via webhook
  2. Coolify fetches latest code from the configured branch
  3. Nixpacks/Docker builds a new image using the install + build commands
  4. New container starts (rolling update — zero downtime)
  5. Old container stops

Full logs are visible in Coolify → application → Deployments tab.

JK Docs
New Guide

Categories

DevOpsBackendFrontendDatabaseToolsSecurityDesignSystem Admin
Admin Panel