Overview

The Senthor Caddy connector integrates into your Caddyfile via a simple import. It uses Caddy's reverse proxy to analyze incoming requests through the Senthor API and apply your protection rules.

Main features

• Protection via Caddy's built-in reverse proxy
• Graceful connection error handling
• Sensitive headers (cookies, authorization) automatically stripped
• Detailed analytics via Senthor dashboard

Installation

1. Download the configuration file

Place the senthor.caddy file next to your Caddyfile:

# Télécharger depuis votre dashboard Senthor
wget -O senthor.caddy \
  https://app.senthor.io/connectors/caddy/senthor.caddy

2. Add the import to your Caddyfile

In your site block, add `import senthor.caddy` inside the route directive:

www.example.com {
    root * /path/to/your/site

    encode zstd gzip
    header Cache-Control "public, max-age=31536000, immutable"

    route {
        import senthor.caddy
        file_server
    }

    handle_errors {
        file_server {
            status 200
        }
    }
}

3. Restart Caddy

Reload Caddy to apply the changes:

sudo systemctl reload caddy

How it works

Once configured, the Senthor Caddy connector:

• Intercepts each request via the built-in reverse proxy
• Sends metadata (host, URI, IP, method) to the Senthor API
• Automatically strips sensitive headers before transmission
• Adds the PAYMENT-RESPONSE header for paywall handling

That's it!

Your Caddy server is now protected. You can track statistics and configure protection rules from your Senthor.io dashboard.

Automatic update (cron)

To keep your Senthor configuration always up to date, you can set up a cron job that automatically downloads the latest version of the senthor.caddy file:

# Cron : mise à jour automatique de senthor.caddy (1x/jour à minuit)
0 0 * * * wget -qO /path/to/senthor.caddy \
  https://app.senthor.io/connectors/caddy/senthor.caddy \
  && systemctl reload caddy

To set up the cron job, open your crontab:

crontab -e

• The file is automatically updated every day at midnight
• Caddy is automatically reloaded after the update
• If the download fails, the previous configuration is preserved

Support

For any questions about Caddy integration, contact us at contact@senthor.io

Download the configuration file

The senthor.caddy file is available directly from your Senthor dashboard: