CI/CD with Git Providers
Applications in Coolify are designed to be deployed directly from Git repositories, enabling continuous integration and continuous deployment (CI/CD) workflows. This means your applications automatically update when you push code changes to your repository.
How Git Integration Works
When you deploy an application in Coolify, you connect it to a Git repository from any Git provider. Coolify works with all Git platforms, including:
- GitHub - Full GitHub App integration or deploy keys
- GitLab - GitLab integration with webhooks
- Bitbucket - Bitbucket integration with webhooks
- Gitea - Self-hosted Git platform
- Any other Git provider - Works with any Git-compatible platform with publicly accessible repositories or using deploy keys
Once connected, Coolify:
- Pulls your source code from the repository
- Builds a Docker image using your chosen build pack
- Deploys the container to your server
- Watches for changes and automatically redeploys when you push new commits (if auto-deploy is enabled)
Key Benefits of Git-Based Deployments
Automatic Deployments
Push code to your repository and Coolify automatically builds and deploys your application. No manual intervention needed.
Preview Deployments
Test pull requests in isolated environments before merging to production. Each PR gets its own unique URL.
Version Control Integration
- Track deployment history alongside your code commits
- Roll back to previous versions easily
- See exactly what code is running in production
CI/CD Workflows
- Integrate with GitHub Actions, GitLab CI, and other CI tools
- Run tests before deployment
- Automate complex deployment pipelines
Alternative: Deploy Without Git
If you want to deploy your own application without connecting to a Git provider, you can deploy it as a Service instead. Services allow you to:
- Upload a Docker Compose file directly to Coolify
- Deploy from Docker images without source code
- Manage the application manually without Git integration
This is useful for scenarios where you build your Docker images elsewhere or prefer manual control over deployments.
Repository Access Methods
Coolify supports multiple ways to access your Git repositories:
Public Repositories
Simply provide the HTTPS URL of your public repository. No authentication needed. Works with any Git provider.
Private Repositories
Choose from authentication methods based on your Git provider:
-
Git Provider App Integration (Recommended for supported providers)
- Available for GitHub
- Full integration with automatic webhooks
- Pull request deployments
- Commit status updates
- No SSH key management
-
Deploy Keys (Works with any Git provider)
- SSH-based authentication
- Universal support - works with any Git platform
- More manual webhook setup required
- Better for air-gapped or restricted environments
- Ideal for custom or self-hosted Git servers
Supported Git Providers
While we provide detailed integration guides for popular platforms, Coolify works with any Git provider that supports standard Git protocols:
- Public Repositories: Any Git provider (no authentication required)
- With App Integration: GitHub
- With Deploy Keys: Any Git provider (GitHub, GitLab, Bitbucket, Gitea, Gogs, Forgejo, self-hosted solutions, and more)
Next Steps
Ready to connect your Git provider? Choose your platform for detailed setup guides:
- GitHub Integration - Connect GitHub repositories
- GitLab Integration - Connect GitLab repositories
- Bitbucket Integration - Connect Bitbucket repositories
- Gitea Integration - Connect self-hosted Gitea
- Other Git Providers - Connect Gogs, Forgejo, or any custom Git server
Or learn about Build Packs to understand how Coolify transforms your code into running containers.
Docker Compose Build Packs
Deploy multi-container applications with Docker Compose using custom domains, magic environment variables, storage volumes, and service networking.
Overview
Integrate GitHub with Coolify to deploy applications from repositories, enable automatic deployments, and manage pull requests seamlessly.