Swarmhook is a minimal self-hosted webhook that listens for image push notifications and updates Docker Swarm services labeled with autodeploy.enabled=true, enabling secure push-to-deploy without CI runner or SSH.

Stars

6

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It simplifies continuous deployment for Docker Swarm by eliminating the need for SSH access or exposing the Docker API, using a simple webhook pattern with bearer token auth and optional Slack notifications.

Who it is for

  • Docker Swarm operators
  • DevOps teams using Docker Swarm in self-hosted environments
  • Developers seeking a lightweight CD solution for Swarm
  • Teams wanting to avoid CI runner dependency for deployment

Use cases

  • Automatically update services after CI builds push new images
  • Deploy multiple services sharing the same image repository in one request
  • Integrate with GitHub Actions or other CI via curl to trigger rolling updates
  • Receive Slack notifications on each deployment for visibility

Strengths

  • No SSH or exposed Docker API required, reducing attack surface
  • Lightweight and single-purpose, easy to deploy as a Docker stack
  • Uses Docker secrets for credential management, enhances security
  • Implements image-based service matching, allowing simultaneous updates of all services using an image

Considerations

  • Only works with Docker Swarm, not standalone Docker or Kubernetes
  • Requires mounting docker.sock, which gives root-equivalent access to host
  • No support for complex deployment strategies like canary or blue-green out of the box

README quick start

Getting started

Description

Push-to-deploy webhook for Docker Swarm. No SSH, no exposed daemon, no CI runner.

Related repositories

Similar projects matched by category, topics, and programming language.

deerwork-ai
Featured
deerwork-ai GitHub avatar

deer-workflow

An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.

AI & Machine LearningLarge Language Models
312
yaojingang
Featured
yaojingang GitHub avatar

TokHub

TokHub is an open-source monitoring, recommendation, and OpenAI-compatible gateway system for AI API intermediaries, combining public status pages, supplier rankings, user workspaces, layered probing, metering, alerts, encrypted keys, and Docker self-hosting.

AI & Machine LearningBackend & APIs
189
amitshekhariitbhu
Featured
amitshekhariitbhu GitHub avatar

ai-agents-tutorial

A comprehensive step-by-step tutorial series that teaches AI agents from scratch, covering function calling, agent loops, ReAct, reflection, plan-and-execute, multi-agent systems, orchestration, evaluation, and related concepts like RAG, GraphRAG, and LangChain.

AI & Machine LearningLarge Language Models
136