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

GitHub Release GitHub Release Date

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

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