Title: Module crowdsec - Caddy Documentation

URL Source: https://caddyserver.com/docs/modules/crowdsec

Markdown Content: Module crowdsec - Caddy Documentation

===============

Documentation

a project

Search K

DownloadDocumentationForumGitHubAccountSupportSponsor

• Welcome

• Wiki

• Get Caddy

• Install

• Build from source

• Tutorials

• Getting Started

• Quick-starts

  • Using the API
  • Using a Caddyfile
  • Static files
  • Reverse proxy
  • HTTPS

• Caddy API

• Caddyfile

• Reference

• Command Line

• API

• Caddyfile

  • Concepts
  • Global options
  • Directives
  • Request matchers
  • Response matchers
  • Common patterns

• Modules

• JSON Config Structure

• Automatic HTTPS

• Articles

• Caddy Architecture

• Conventions

• Config Adapters

• Keep Caddy Running

• How Logging Works

• Monitoring Caddy

• Profiling Caddy

• Verifying Asset Signatures

• Upgrading to Caddy 2

• Developers

• Extending Caddy

  • Caddyfile Support
  • Config Adapters
  • Placeholders

• Module Namespaces

• v1 Docs

This page lists all registered Caddy modules. Modules are plugins which extend Caddy's JSON configuration structure.

We recommend using your browser's "Find in page" feature for quick lookups.

There is more than one module named Module crowdsec. Choose one by its repository.

This module does not come with Caddy. It can be added by using xcaddy or our download page. Non-standard modules may be developed by the community and are not officially endorsed or maintained by the Caddy project. The documentation is shown here only as a courtesy.

Code repository:

Custom builds:xcaddy build --with

▸github.com/hslatman/caddy-crowdsec-bouncer

{▾ "api_key": "", "api_url": "", "ticker_interval": "", "enable_streaming": false, "enable_hard_fails": false}

Non-standardThis module does not come with Caddy. It can be added by using xcaddy or our download page. Non-standard modules may be developed by the community and are not officially endorsed or maintained by the Caddy project. The documentation is shown here only as a courtesy.

Code repository: https://github.com/hslatman/caddy-crowdsec-bouncer

Custom builds:xcaddy build --with github.com/hslatman/caddy-crowdsec-bouncer/crowdsec

crowdsec is a Caddy App that functions as a CrowdSec bouncer. It acts as a CrowdSec API client as well as a local cache for CrowdSec decisions, which can be used by the HTTP handler and Layer4 matcher to decide if a request or connection is allowed or not.

🔗api_key APIKey for the CrowdSec Local API

🔗api_url APIUrl for the CrowdSec Local API. Defaults to http://127.0.0.1:8080/

🔗ticker_interval TickerInterval is the interval the StreamBouncer uses for querying the CrowdSec Local API. Defaults to "10s".

🔗enable_streaming EnableStreaming indicates whether the StreamBouncer should be used. If it's false, the LiveBouncer is used. The StreamBouncer keeps CrowdSec decisions in memory, resulting in quicker lookups. The LiveBouncer will perform an API call to your CrowdSec instance. Defaults to true.

🔗enable_hard_fails EnableHardFails indicates whether calls to the CrowdSec API should result in hard failures, resulting in Caddy quitting vs. Caddy continuing operation (with a chance of not performing) validations. Defaults to false.

Fulfilled by modules in namespace:

This property is required because it specifies the module name.

An open source Go community project

in partnership with Ardan Labs

Privacy-respecting analytics by Fathom

© 2025 ZeroSSL. All rights reserved.

Caddy® is a registered trademark of ZeroSSL GmbH.