Repolode
Submit
kimdre

kimdre/doco-cd

A lightweight GitOps tool that deploys and updates Docker Compose projects and Swarm stacks from Git via polling or webhooks.

View on GitHubWebsite
Stars
1,767
Forks
66
Open issues
19
Last commit
12 hours ago

What is it?

doco-cd is a declarative continuous delivery tool for Docker. It watches Git repositories or OCI artifacts and automatically deploys and updates Docker Compose projects and Swarm stacks, using either polling or webhooks as the trigger. It is positioned as a simpler alternative to Portainer or ArgoCD for Docker hosts.

The project ships as a distroless image with small RAM and CPU requirements. Secrets can be pulled from external providers or encrypted with SOPS, and a single instance can deploy to multiple Docker hosts through Docker Contexts. Deployments can be limited to timezone-aware sync windows, and pre- and post-deployment scripts run around each update.

For monitoring and automation, doco-cd exposes Prometheus metrics, sends notifications, and provides a REST API and an MCP server.

Key features

  • 01Deploys Docker Compose projects and Swarm stacks from Git repositories or OCI artifacts.
  • 02Triggers deployments through webhooks, polling, or cron-scheduled polling.
  • 03Decrypts SOPS-encrypted files and reads secrets from external providers.
  • 04Deploys to multiple Docker hosts via Docker Contexts.
  • 05Exposes Prometheus metrics, notifications, a REST API, and an MCP Server.

Use cases

  • Running self-hosted services on a single Docker host with Git as the source of truth.
  • Deploying the same Compose stack to several Docker hosts from one configuration.
  • Restricting production rollouts to specific time windows.
  • Replacing manual docker compose up steps with automated GitOps-style updates.

Topics

#gitops#docker-compose#continuous-deployment#docker#docker-swarm#webhook#devops#continuous-delivery#doco-cd#swarm-mode

FAQ

What is doco-cd?
A lightweight GitOps tool that deploys and updates Docker Compose projects and Swarm stacks from Git via polling or webhooks. doco-cd is a declarative continuous delivery tool for Docker. It watches Git repositories or OCI artifacts and automatically deploys and updates Docker Compose projects and Swarm stacks, using either polling or webhooks as the trigger. It is positioned as a simpler alternative to Portainer or ArgoCD for Docker hosts.
Is doco-cd free to use? What license does it have?
doco-cd is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is doco-cd still maintained?
Actively maintained. The last commit to doco-cd was on Nov 7, 2026.
What can I use doco-cd for?
Running self-hosted services on a single Docker host with Git as the source of truth. Deploying the same Compose stack to several Docker hosts from one configuration. Restricting production rollouts to specific time windows. Replacing manual docker compose up steps with automated GitOps-style updates.
Where can I get doco-cd?
The source code and installation instructions are on GitHub: https://github.com/kimdre/doco-cd

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects