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 various external secret management providers and data encryption with SOPS
• Can deploy applications via webhooks and/or polling.
• Supports various Git providers
• Supports both Docker Compose projects and Swarm stacks in Swarm mode.
• Provides notifications and Prometheus metrics for monitoring.

Getting Started¶

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

More resources:

1. Known Limitations - Learn about the limitations of the application.
2. Tips and Tricks - Some tips and tricks for using the application.

Supported Git Providers¶

See more info here: Setup Webhook

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

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

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