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.
• Runs with a minimal (distroless) image
• Built in Go with tiny RAM and CPU requirements.
• Supports both Docker Compose projects and Swarm stacks in Swarm mode.
• Can deploy applications via webhooks and/or polling.
• Supports various Git providers
• Supports OCI artifacts and Git repositories for deployment configurations.
• Supports various external secret management providers and data encryption with SOPS
• Supports Job Scheduling / Cron Jobs for running periodic tasks.
• Provides Notifications and Prometheus metrics for monitoring.

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 - Run two Doco-CD instances that manage each other for self-updating.

Supported Git Providers¶

• GitHub
• GitLab
• Gitea
• Forgejo
• Gogs
• Azure DevOps* (Service Hooks not supported)

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.114.0):

ghcr.io/kimdre/doco-cd:0.114.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¶