Built with Rust · Open Source

Lightweight GitOps for Docker

Automate Docker Compose deployments straight from your Git repository. A single Rust binary with GitOps polling, health-checked rolling updates, and automatic rollback — no orchestrator required.

RustPerformance & Safety
~15 MBSingle Binary
ZeroProduction Panics

Core Features

Everything you need to keep Docker Compose services in sync with your Git repository — automatically, reliably, and securely.

GitOps Automation

Repository polling, webhook triggers, and multi-branch deployments across environments. Features secure authentication, application auto-discovery, and a lifecycle event system for orchestration.

PollingWebhooksMulti-branchRetry Logic

Docker Compose Integration

Orchestration with environment-specific profile activation and variable injection. Supports rolling updates with health checks. Advanced strategies requiring traffic splitting (blue-green, canary) are planned as future features.

RollingHealth ChecksBlue-Green (Planned)Canary (Planned)

AI Model Management

Deploy AI models via Docker Model Runner. Supports llama.cpp and vLLM inference engines with OpenAI-compatible APIs, health monitoring, and resource management.

Docker Model Runnerllama.cppREST APIAsync Polling

Offline-First / Resilient

Designed for constrained or unreliable networks. Features offline mode for graceful outage handling, multi-site synchronization, and token-bucket bandwidth control to manage resource utilization.

Offline ModeBandwidth MgmtMulti-SiteLRU Cache

Secure Self-Update

Automatic update checking with Ed25519 signature verification for binary authenticity. Includes health-check based automatic rollback, zero-downtime binary replacement, and update history tracking.

Ed25519Auto-RollbackChannelsKey Rotation

Observability

Native Prometheus metrics endpoint, Loki log streaming integration, and OpenTelemetry tracing support. Monitor deployments, container health, and agent performance in real time.

PrometheusLokiOpenTelemetry

Configuration Management

Version-tracked configurations with a built-in diff engine, rollback validator, and Git sync. Changes are tracked and can be rolled back to any previous state.

VersioningDiff EngineRollbackGit Sync

Pre-Download Management

Priority queue for Docker image pre-pulls with bandwidth control and automatic cache cleanup. Ensures containers are ready before deployment windows open, minimizing downtime.

Priority QueueBandwidth ControlCache Cleanup

Maintenance Windows

Schedule deployments with cron expressions. Define recurring maintenance windows, one-time overrides, and black-out periods to deploy on your terms — not on every push.

Cron SchedulingRecurringOverride

Security & Integrity

Encryption, signing, and access control built into every layer by default.

AES-256-GCM Encryption

All credentials and secrets encrypted at rest. Credential health monitoring with rotation alerts and expiration tracking.

OIDC Authentication via Zitadel

Standards-based authentication with PKCE flow, JWKS caching, RS256 verification, silent token renewal, and automatic user provisioning.

Mutual TLS & HTTPS by Default

Hub deploys with HSTS (1-year), secure cookies, and SSL redirect out of the box. Agent-to-Hub communication secured with mTLS (future release).

Ed25519 Audit Signing

Tamper-proof audit trail with Ed25519-signed log entries. Complete deployment history for forensic and compliance review.

CVE Scanning & SBOM

Container vulnerability scanning with CycloneDX and SPDX SBOM generation. Dedicated SBOM Dashboard in the Hub for supply-chain visibility.

Rate Limiting & Input Validation

Token-bucket rate limiting, CORS policies, comprehensive input validation, and bearer-token API protection across all endpoints.

Architecture

A typical GitOps deployment flow — from git push to running services, with centralized Hub oversight.

Git Repository

Push triggers change

MicroCD Agent

Poll / webhook detect

Docker Compose

Strategy & health checks

Running Services

Your applications, live

status reports ↓
↑ commands
MicroCD Hub

Optional dashboard for monitoring & config

Agent Components

Built with Rust — zero production panics, 11 domain error enums, intelligent retry logic.

Git Manager Config System State Manager Compose Manager Model Manager Network Manager Status Reporter Audit Logger Web Dashboard Rollback System Self-Updater Pre-Download Engine Lifecycle Hooks

MicroCD Hub (Optional)

An optional companion dashboard for monitoring your agents and pushing configuration updates. Built with Django and React.

Real-time agent status and deployment tracking
Push configuration updates to connected agents
AI model deployment commands and progress tracking
OIDC authentication with Zitadel
Dashboard

Agent overview, deployment history & logs

AI Models

Pull, deploy & monitor models on your hosts

Config & Releases

Version-tracked config, release publish pipeline

Security

OIDC auth, audit logs & SBOM dashboard

Get Started

Up and running in minutes.

Quick Install
$ curl -fsSL https://packages.microcd.dev/install.sh | bash

Also available via Homebrew and as a Proxmox LXC deployment with dual GHCR/source install modes.

Setup Steps
1

Install MicroCD with the one-line installer or from source.

2

Generate a configuration file:

microcd --generate-config microcd.yaml
3

Point it at your Git repo and run:

microcd --config microcd.yaml
4

Access the local web dashboard:

http://localhost:8080

Deploy Anywhere

From cloud VMs to Proxmox LXC containers — MicroCD fits your infrastructure.

Linux (x86_64 / ARM) Proxmox LXC Docker Cloud VMs Homebrew