binhex-caddy-duckdns

Overview

Caddy is a powerful, enterprise-ready, open source web server with automatic HTTPS written in Go. This image includes the DuckDNS DNS challenge plugin, enabling automatic TLS certificate issuance and renewal via Let's Encrypt for DuckDNS hostnames without requiring port 80 to be open. Ideal for use as a reverse proxy on a home network.

Requirements

Caddyfile
Place your Caddyfile at '/config/caddy/Caddyfile'.

Runtime arguments

Web UI: http://[IP]:[PORT:8080]
Network: bridge
Shell: bash
Privileged: false
Extra Params: --restart=unless-stopped

Template configuration

Port: HTTPSPorttcp

The HTTPS port Caddy listens on. Must match https_port in your Caddyfile.

Target: 8443
Default: 8443

Port: HTTPPorttcp

The HTTP port Caddy listens on (used for redirects). Must match http_port in your Caddyfile.

Target: 8080
Default: 8080

Port: AdminPorttcp

The admin edpoint port for Caddy.

Target: 2019
Default: 2019

Path: /configPathrw

This is the container path to your Caddy configuration file (Caddyfile) and logs.

Target: /config
Default: /mnt/user/appdata/caddy-duckdns

Variable: DUCKDNS_TOKENVariable

Duck DNS token for automatic TLS certificate issuance and renewal, sign into Duck DNS to view your token.

Target: DUCKDNS_TOKEN

Variable: ENABLE_HEALTHCHECKVariable

Enable or disable healthchecks.

Target: ENABLE_HEALTHCHECK
Default: yes|no

Variable: HEALTHCHECK_COMMANDVariable

The command or script to execute, if not specified then the script healthcheck.sh will be used (process, dns and https checking).

Target: HEALTHCHECK_COMMAND

Variable: HEALTHCHECK_ACTIONVariable

The action to execute if the healthcheck command returns a non zero exit code, if not specified the action will be 'exit 1', if you want the container to exit on failure then set the action to 'kill 1'.

Target: HEALTHCHECK_ACTION

Variable: HEALTHCHECK_HOSTNAMEVariable

The hostname used when performing HTTPS and DNS healthchecking.

Target: HEALTHCHECK_HOSTNAME
Default: google.com

Variable: PUIDVariable

User ID for the running container

Target: PUID
Default: 99

Variable: PGIDVariable

Group ID for the running container

Target: PGID
Default: 100

Variable: UMASKVariable

UMASK for the running container

Target: UMASK
Default: 000

Links

Template Support Registry Project

Details

Repository

ghcr.io/binhex/arch-caddy-duckdns

Registry

https://github.com/binhex/arch-caddy-duckdns/pkgs/container/arch-caddy-duckdns

Last Updated2026-04-10

First Seen2026-04-09

Run binhex-caddy-duckdns on Unraid.

binhex-caddy-duckdns is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS