Skip to content
Kim Oliver Drechsel edited this page Sep 30, 2024 · 22 revisions

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 via webhooks when a change is pushed to a Git repository.

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

Features

  • Simple setup: Doco CD is easy to set up and use.
  • Secure: The application runs with a minimal (distroless) image with minimal permissions and supports webhook authentication.
  • Flexible: The deployments can be configured using a deployment configuration file.
  • Customizable: The application can be configured using environment variables.
  • Lightweight: The application is built in Go and has very small memory and CPU requirements.

Getting Started

  1. Quickstart - Learn how to run the application.
  2. App Settings - Configure the application settings.
  3. Deploy Settings - Configure the Docker Compose deployment in your repositories.
  4. Setup Access Token - Create an access token for the application.
  5. Setup Webhook - Set up a webhook for your deployments.
  6. Tips and Tricks - Some tips and tricks for using the application.
  7. Known Limitations - Learn about the limitations of the application.

Supported Git Providers

  • GitHub
  • GitLab
  • Gitea

Releases and Changelog

GitHub Release GitHub Release Date

See the releases page for release notes and changelogs.

Image

You can find the Docker image on GitHub Container Registry.

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

Community

Clone this wiki locally