Doco-CD Documentation¶

What is Doco-CD?¶

Doco-CD stands for Docker Compose Continuous Deployment and is a lightweight GitOps tool that automatically deploys and updates Docker Compose projects and Swarm stacks via webhooks or polling when a change is pushed to a Git repository.

You can think of it as a simple Portainer or ArgoCD alternative for Docker.

Features¶

• Easy to set up and use with minimal configuration.
• Runs with a minimal (distroless) image with tiny RAM and CPU requirements.
• Supports various Git providers
• Deploy via webhooks and/or polling.
• Supports both Docker Compose projects and Swarm stacks in Swarm mode.
• Supports OCI artifacts and Git repositories for deployment configurations.
• Supports various external secret providers and encryption with SOPS
• Deploy to multiple Docker hosts with Docker Contexts.
• Control when deployments may happen with timezone-aware sync windows and cron-scheduled polling.
• Provides Notifications and Prometheus metrics for monitoring.
• Job Scheduling / Cron Jobs, Pre/Post-deployment scripts, REST API and MCP Server for advanced automation and integrations.

Getting Started¶

Follow the Getting Started Guide to get started with Doco-CD.

More resources:

1. Core Concepts - Learn about the core concepts of Doco-CD.
2. Known Limitations - Learn about the limitations of the application.
3. Tips and Tricks - Some tips and tricks for using the application.
4. Self-Updating - Bootstrap a single instance to manage and update its own stack.

Supported Git Providers¶

• GitHub
• GitLab
• Gitea
• Forgejo
• Gogs
• Azure DevOps¹ (Service Hooks not supported)
• Plain Git servers without a forge (bare repositories via SSH, HTTP(S) or the local filesystem)

More info at Setup Access Token and Setup Webhook.

Releases and Changelog¶

See the releases page for release notes and changelogs or the Security Policy for more information.

Image¶

You can find the Docker image in the GitHub Container Registry.

docker pull ghcr.io/kimdre/doco-cd:latest

To use a specific version, replace latest with the desired release version without the leading v (e.g. 0.129.0):

ghcr.io/kimdre/doco-cd:0.129.0

Community¶

• Ask questions on GitHub Discussions
• Report bugs or suggest features by opening an issue

Contributing¶

Contributions are welcome! Please see the Contributing Guidelines for more information.

In the Media¶

Doco-CD has been featured by industry media and technical publications:

Support the Project¶

If you would like to support the development of Doco-CD, please consider becoming a sponsor on GitHub Sponsors.

Doco-CD is proudly supported by

Star History¶