arbianshkodra/accelero repository overview

⁠Accelero

GitOps-powered Docker deployment automation with zero downtime.

⁠What is Accelero?

Accelero is a lightweight, single-binary tool that brings GitOps to Docker Compose environments. It manages multiple deployment stacks, each backed by a git repository containing a docker-compose.yaml. Accelero continuously reconciles the desired state in git against the actual running containers, deploying changes automatically with zero downtime.

Think of it as ArgoCD/Flux for Docker Compose — git is the source of truth, drift is detected and corrected, and deployments are fully automated.

⁠Quick Start

docker run -d \
  --name accelero \
  -p 8000:8000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v accelero-data:/data \
  -e API_KEY=your-secure-key \
  arbianshkodra/accelero

⁠Then create your first stack:

curl -X POST http://localhost:8000/api/v1/stacks \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-secure-key" \
  -d '{
    "name": "my-app",
    "repo_url": "https://github.com/your-org/your-gitops-repo",
    "repo_username": "your-username",
    "repo_token": "your-token",
    "compose_path": "docker-compose.yaml",
    "auto_deploy": true,
    "reconcile_interval_seconds": 300
  }'

⁠Features

• Multi-stack management — Manage multiple independent stacks via REST API
• GitOps reconciliation — Periodic drift detection and auto-deploy
• Zero-downtime deployments — New containers health-checked before old ones removed
• Automatic rollback — Pre-deployment state captured and restored on failure
• Dependency resolution — Services deployed in correct order based on depends_on
• SQLite persistence — Deployment history and stack config survive restarts
• Flexible triggers — Deploy via webhook, reconciliation, or manual API call

⁠Documentation

• Full documentation and API reference: accelero.sh/docs

⁠Source code

• github.com/arbianshkodra/accelero