Back to ChangelogNovember 6, 2026

Official Caddy plugin: Integration Mode, built into Caddy

RedirHub + Caddy: RedirHub Integration Mode is now an official Caddy plugin

Caddy serves the redirects. RedirHub keeps the rules and the analytics.

When we launched Integration Mode, we said more official plugins were on the way. The first one is here: caddy-redirects is now an official Caddy plugin, listed on Caddy's own download page.

If your domains point at your own Caddy server, they can stay there. Caddy serves the redirects, website migrations, branded short links and QR codes you manage in RedirHub, and reports every redirect back, so Analytics, filters and link history work exactly as they do for a domain connected by DNS.

What you get#

  • Changes in seconds. When you edit a link, RedirHub signals Caddy and Caddy fetches the new rules at once. No Caddyfile edit, no reload. If the signal is ever missed, Caddy still checks for changes every minute.
  • 404 monitoring. Caddy also reports the 404s your site answers, so broken links show up in Analytics before your visitors find them.
  • Your site stays in charge. Specific redirects run before your own pages. A domain-wide catch-all only answers when your site itself returns a 404, so it never takes over a page that works.
  • Ready after a restart. Caddy keeps the last good copy of your rules on disk, so it redirects at once after a restart, even if the rules can't be fetched.
  • HTTPS only where you need it. With on-demand TLS, Caddy gets certificates only for the hostnames in your rules.

Set it up#

  1. Get Caddy with the plugin: on Caddy's download page, select github.com/redirhub/caddy-redirects, or build it yourself with xcaddy build --with github.com/redirhub/caddy-redirects.
  2. In RedirHub, open the Integration key panel and copy your workspace rules address and your integration key.
  3. Add a redirects block with your rules_url and key to your site in the Caddyfile. One workspace rules address covers every domain that server runs.
  4. In RedirHub, set the domain to use your own platform. Caddy answers the check path on your domain and RedirHub shows it as Connected.

Open source#

The plugin is open source under the Apache-2.0 license, and so is its rules format. Source, full Caddyfile examples and release notes are on GitHub; the module reference is in Caddy's documentation.

Official Caddy plugin: Integration Mode, built into Caddy - Changelog - RedirHub