Public | Automated Build

Last pushed: a year ago
Short Description
Docker hub webhook
Full Description


Automatic docker deployment with webhooks.

dockerhub-webhook listens to incoming HTTP POST-requests from and triggers your specified script(s).


  • Lightweight
  • Pretty simple setup process
  • Can be runned in a docker container
  • Supports updating multiple docker images
  • Scripts can trigger docker or docker-compose
  • Used in production
  • Good logging

Create a token

Create a secret token with openssl, uuidgen or something else. Don't use any slashes since token is going to be used in the URL.

export TOKEN=$(uuidgen)
echo $TOKEN

Installation alternatives

1. Run on host


Nodejs and npm must be installed.

git clone
cd dockerhub-webhook
npm i

Edit config

See config/index.js

vim config/index.js

Configure repos and scripts

See scripts/index.js

vim scripts/index.js

Start dockerhub-webhook

npm start

2. Run with docker-compose

Git clone

git clone

Add secret token in dockerhub.env with

vim dockerhub.env

Start with

docker-compose up -d

3. Run from docker hub

Git clone

git clone

Start with

docker run -d \
  -p 3000:3000 \
  -e SERVER_PORT=3000 \
  -e TOKEN=${token} \
  -e ROUTE=/api \
  -v ${PWD}/scripts:/src/scripts \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --name dockerhub-webhook \

Configuration on docker hub

Go to -> your repo -> Webhooks

Add a webhook like on the following image.

Replace with the domain of your server or it's ip address.

Replace abc123 with your secret token.

docker-hook listens to port 3000 by default.

Docker Pull Command
Source Repository