GitHub

Upgrade Caddy and Cloudflared

This runbook covers how to upgrade the Caddy and Cloudflared versions used by THB applications

Image Locations

Image GCR Location
Caddy gcr.io/the-helper-bees/caddy2-with-transform-encoder-plugin:latest
Cloudflared gcr.io/the-helper-bees/cloudflared:latest

Finding Latest Versions

Upgrade Process

Step 1: Edit the Dockerfile

Each Dockerfile has a version variable at the top (line 1) that you can edit:

Caddy (src/images/caddy/Dockerfile):

ARG CADDY_VERSION=2.11

Cloudflared (src/images/cloudflared/Dockerfile):

ARG CLOUDFLARED_VERSION=2025.11.1

Step 2: Submit a PR

Create a PR targeting the plan branch with your version change.

Step 3: Merge and Deploy

Once merged, GitHub Actions will automatically:

  1. Build the new Docker image
  2. Push it to GCR with the :latest tag (the Caddy build also pushes a date tag, e.g., :2026-02-23-1430; Cloudflared only pushes :latest)

The updated image will be pulled on the next container restart/deployment.

Manual Build (Optional)

To test locally before submitting a PR, run the build script with --no-push:

# Caddy
cd src/images/caddy
./build.sh --no-push

# Cloudflared
cd src/images/cloudflared
./build.sh --no-push
Edit this page