Docker Hub image pushed notifications on your phone.

Get a low-priority push notification when a new image is pushed to your Docker Hub repository, optionally only for tags you choose.

Install in Studio See the setup

pushCI/CD Releases & app review

Monday 5 October

9:41

JustPushnow

Image pushed

Get a low-priority push notification when a new image is pushed to your Docker Hub repository, optionally only for tags you choose.

How it works

Three steps to your first push

STEP 01

Install the recipe

One click in Studio gives you a personal webhook URL.

STEP 02

Paste your URL into Docker Hub

Add it as a webhook for Image push.

STEP 03

Get a push on your phone

With the text, sound and buttons from the recipe.

Setup

How to set up the Docker Hub image push webhook

Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
On Docker Hub, open your repository and select the Webhooks tab (repository owners, or organization owners and editors).
Give the webhook a name, paste your webhook URL as the webhook URL and select Create.https://••••••••/•••••••• your personal URL, shown after install
On Docker Hub, open the repository's **Webhooks** tab, give the webhook a name, paste the URL above and select **Create**. Every push to the repository sends a webhook.
To only hear about certain tags, add them to the URL, separated by commas:
```
your webhook URL?tag=latest,stable
```
Docker Hub's payload has no signature or secret, so keep your endpoint URL private.

The code

What runs when the webhook arrives

Studio calls handleRequest(request) with the incoming webhook and sends the message it returns. It's yours after install; change anything.

transform.js
 1// Docker Hub → image pushed
 2// Fires when a Docker Hub repository webhook reports a push to the repository.
 3// Optional ?tag=latest,stable on the webhook URL limits it to those tags.
 4// Docs: https://docs.docker.com/docker-hub/repos/manage/webhooks/
 5
 6// Month names, so the date reads the same in every runtime.
 7const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
 8
 9// Only link to real http(s) URLs.
10function link(url, cta) {
11    return typeof url === "string" && /^https?:\/\//.test(url) ? [{ cta, url }] : []
12}
13
14// A plain, non-empty string or null.
15function text(value) {
16    return typeof value === "string" && value.trim() ? value.trim() : null
17}
18
19function handleRequest(request) {
20    const body = request.body && typeof request.body === "object" ? request.body : {}
21    const push = body.push_data && typeof body.push_data === "object" ? body.push_data : null
22    const repo = body.repository && typeof body.repository === "object" ? body.repository : {}
23    const name = text(repo.repo_name) ?? ([text(repo.namespace), text(repo.name)].every(Boolean) ? `${repo.namespace}/${repo.name}` : null)
24
25    // Guard: only Docker Hub push webhooks.
26    if (!push || !name) {
27        console.log("Not a Docker Hub push — skipping")
28        return null
29    }
30
31    const tag = text(push.tag)
32
33    // ?tag=latest,stable on the webhook URL only pushes for those tags.
34    const wanted = String(request.query?.tag ?? "").split(",").map((t) => t.trim()).filter(Boolean)
35    if (wanted.length && !(tag && wanted.includes(tag))) {
36        console.log(`Skipping tag "${tag ?? "none"}" (not in ?tag=${wanted.join(",")})`)
37        return null
38    }
39
40    // pushed_at is Unix seconds; show the date only, in UTC.
41    let when = null
42    if (typeof push.pushed_at === "number" && Number.isFinite(push.pushed_at)) {
43        const date = new Date(push.pushed_at * 1000)
44        if (!Number.isNaN(date.getTime())) when = `${date.getUTCDate()} ${MONTHS[date.getUTCMonth()]} ${date.getUTCFullYear()}`
45    }
46    const pusher = text(push.pusher)
47    const message = [pusher ? `Pushed by ${pusher}` : null, when].filter(Boolean).join(" · ")
48
49    return {
50        title: `🐳 ${name}${tag ? `:${tag}` : ""} pushed`,
51        message: message || "A new image is on Docker Hub",
52        topic: "Docker Hub",
53        priority: -1, // Routine: a new image is good news, not an emergency.
54        buttons: link(`https://hub.docker.com/r/${name.split("/").map(encodeURIComponent).join("/")}/tags`, "View tags"),
55    }
56}

Payload

The Docker Hub push webhook

This is what Docker Hub sends to your URL for image push. It is a sample, trimmed to the fields recipes use.

push · sample.json
 1{
"push_data": {
  "tag": "latest",
  "pusher": "acmebuilder",
  "pushed_at": 1790671980
},
"repository": {
  "name": "api",
  "owner": "acme",
  "status": "Active",
  "repo_url": "https://registry.hub.docker.com/u/acme/api/",
  "namespace": "acme",
  "repo_name": "acme/api",
  "is_private": true,
  "is_trusted": false,
  "star_count": 0,
  "description": "Acme API server",
  "is_official": false,
  "date_created": 1758096000,
  "comment_count": 0
},
"callback_url": "https://registry.hub.docker.com/u/acme/api/hook/2141b5bi5i5b02bec211i4eeih0242eg11000a/"
23}

FAQ

Docker Hub image pushed notifications: questions

Does this work on iPhone and Android?

Yes. Install the JustPush app from the App Store or Google Play and sign in. Every phone signed in to your account gets the notification.

Do I need to write code?

No. Install the recipe in Studio, paste your webhook URL into Docker Hub and you are done. The code is there if you want to change the text, the sound or the buttons.

Can I change what the notification says?

Yes. After install the recipe's code is yours. Edit it in Studio and test it against the sample payload before you save.

What does it cost?

JustPush is free for 30 days. After that it's $19.99 a year, or $39.99 once. There is no extra charge for recipes.

Ready when you are

Docker Hub on your phone in two minutes.

Install the recipe, paste one URL, done. Free for 30 days, no credit card required.

Install in Studio Download for iOS Download for Android