Question 1

How do I set up Caddy Docker Proxy with Docker Compose?

Accepted Answer

Define a Caddy service using the plugin image, mount the Docker socket, and configure networks. Then, add labels like `caddy: example.com` and `caddy.reverse_proxy: {{upstreams}}` to your app services. The README provides a basic Compose example with step-by-step instructions.

Question 2

Caddy Docker Proxy vs Traefik: which is better for Docker?

Accepted Answer

Both use Docker labels for dynamic configuration, but Caddy Docker Proxy leverages Caddy's automatic HTTPS out-of-the-box, while Traefik offers more built-in middleware and a broader ecosystem. Choose Caddy for simplicity and TLS automation, or Traefik for advanced routing features.

Question 3

How to troubleshoot when labels aren't working in Caddy Docker Proxy?

Accepted Answer

Inspect the generated Caddyfile at `/config/caddy/Caddyfile.autosave` inside the container to verify label conversion. Ensure containers share the same network as Caddy, and check ingress network settings using the `CADDY_INGRESS_NETWORKS` environment variable if automatic detection fails.

Question 4

Does Caddy Docker Proxy support Kubernetes?

Accepted Answer

No, it's specifically designed for Docker and Docker Swarm environments. For Kubernetes, consider using the Caddy ingress controller or other Kubernetes-native proxy solutions that integrate with Kubernetes resources.

Question 5

How to add custom Caddy plugins to Caddy Docker Proxy?

Accepted Answer

Build a custom Docker image using the official Caddy builder image, add this plugin and others with xcaddy, and override the CMD to `caddy docker-proxy`. The README includes a Dockerfile example for custom builds.

Question 6

Can I use Caddy Docker Proxy without automatic HTTPS for internal services?

Accepted Answer

Yes, set the `caddy.tls` label to `internal` for services that don't need public certificates, or use the `tls` directive in labels to configure custom certificate paths, as shown in the snippet examples.

Question 7

What happens if Docker goes down with Caddy Docker Proxy?

Accepted Answer

Caddy will lose its dynamic configuration source, but it retains the last generated Caddyfile until Docker is restored. However, new containers or changes won't be reflected, so consider redundancy in production setups.

caddy-docker-proxy

What is caddy-docker-proxy?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions