swarm-deploy
GitOps controller for Docker Swarm

Keep your Swarm
in sync with Git.

Continuous delivery built for Docker Swarm. Reconcile stacks, services, and networks. Detect drift. Prune orphaned resources. Audit every deployment.

Configure your cluster ↗ View on GitHub
PullWebhookHybridSwarm-native
swarm-deploy / production
LIVE
SYNC ACTIVITYmaster
⌁
Commit detectedapi: bump image to v2.8.1
±
Diff calculated1 service changed · 0 orphaned
↻
Reconciling stackproduction / api
✓
SyncedDesired state matches cluster
Healthy
stacks12
services47
drift0
01 / PRODUCT

Argo CD ideas.
Swarm-native execution.

Your Git repository is the source of truth. Swarm Deploy continuously compares desired state with the live cluster and applies only what changed — without forcing Kubernetes concepts onto Docker Swarm.

01
↻

Continuous reconciliation

Sync stacks, services, and networks from Git in pull, webhook, or hybrid mode.

02
⌁

Drift detection

See when the live cluster no longer matches declared state and bring it back under control.

03
⌫

Prune orphans

Remove managed services that disappeared from the desired Compose definition.

04
◎

Event history & audit

Keep a durable trail of sync activity, deployments, failures, and infrastructure changes.

05
⌁

UI + API

Operate from a single web server with stack state, realtime service tasks, events, and API access.

06
✦

Operational extras

Notifications, init deploy jobs, secrets rotation, config validation, and an AI assistant.

02 / WORKFLOW

Commit. Reconcile. Done.

No bespoke deployment pipeline required for every stack.

SOURCE OF TRUTH

Git repository

Compose files + Swarm Deploy configuration

services:
  api:
    image: app:2.8.1
commit
→
CONTROL LOOP

Swarm Deploy

Diff · validate · deploy · audit

✓ desired state✓ policies✓ drift
reconcile
→
RUNTIME

Docker Swarm

Native services, networks, configs & secrets

MWWW
↳ Deploys run only when a change is detected in the Compose definition or referenced configs/secrets.
03 / OPERATE

See what your cluster
is actually doing.

GitOps is more useful when the control loop is observable. Swarm Deploy keeps deployment events, service state, task details, and sync outcomes close to the workflow.

  • ✓ Realtime service task snapshot
  • ✓ Persisted event history
  • ✓ Success / failure notifications
  • ✓ Health endpoints and monitoring configs
  • ✓ HTTP API for automation
CLUSTERproduction
● healthy
StacksEventsServices
✓
gateway3 services
Synced
✓
observability5 services
Synced
↻
application8 services
Syncing
✓
storage4 services
Synced
Last reconciliation8 sec ago
04 / ECOSYSTEM

More than a controller.

Small, focused tools for running Docker Swarm infrastructure.

◆↗
SECRETS

cloud-secrets

Synchronize external secrets into native Docker Swarm secrets and roll services when values change.

VaultDocker SecretsPrometheus
≋↗
LOGGING

cloud-vector

Logging components focused on Docker Swarm workloads.
◫↗
NODES

node-agent

Node metrics collection and maintenance helpers for Swarm infrastructure.
▶↗
BOOTSTRAP

init-jobs

Ready-to-use initialization jobs for common deployment workflows.
05 / GET STARTED

From zero to GitOps
without the ceremony.

Start from the basic example, generate configuration with the wizard, then deploy Swarm Deploy as a stack on a manager node.

Open basic example ↗
manager · bash
$ git clone https://github.com/swarm-deploy/swarm-deploy.git
$ cd swarm-deploy/example/01-basic

# Deploy the controller to your Swarm
$ docker stack deploy --with-registry-auth \
    -c docker-compose.yaml swarm-deploy \
    --detach=false
✓ swarm-deploy deployed

Your Swarm already works.
Make deployments work like GitOps.

Open source. Swarm-native. Designed for teams that want continuous delivery without changing orchestrators.

Get Swarm Deploy ↗ Open configurator