No entries match these filters. Clear filters
api-docs-354a88efdea9
Nov 21, 2026
·
issue 146
BunkerWeb adds sensitive-entry redaction to the cache API, withholding secret data from Biscuit-token callers on GET /cache︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
API change
BunkerWeb adds sensitive-entry redaction to the cache API, withholding secret data from Biscuit-token callers on GET /cache︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
+ GET /cache?with_data=true
└──▷ TRY IT
Fetch all cache entries including their data as an HTTP Basic API administrator — secrets are returned; a Biscuit-token caller making the same request will have the data field omitted for sensitive entries.
copy
$ curl -u admin:<password> 'https://<bunkerweb-api-host>/cache?with_data=true'
Retrieve cache entries with data included via GET /cache?with_data=true; the data field is omitted for sensitive entries (names stored as secret, ending in .secret, or core entries holding private keys or credentials) unless the caller authenticates with HTTP Basic as an API administrator — Biscuit tokens are refused access to sensitive data even when issued to an administrator.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet New endpoint documented: GET /cache?with_data=true Not checked yet
2 details in Everything
BunkerWeb adds Zstandard compression, per-service DNSBL DNSBL A DNS-based blocklist: a published list of IP addresses or domains associated with spam or abuse, queried via standard DNS lookups so cyber tools can check reputation in real time without downloading the full list. overrides, JSON ban output, URL-list refresh intervals, a new TLS ClientHello TLS ClientHello The first message a TLS client sends when opening an encrypted connection, advertising supported cipher suites, TLS versions, and extensions. Cyber tools inspect or forge it to fingerprint clients or intercept traffic. plugin phase, and login throttling with configurable lockout settings.
└──▷ GET THIS VERSIONDocker git
Docker
copy
$ docker pull ghcr.io/bunkerity/bunkerweb:1.6.18
git
copy
$ git clone --branch v1.6.18 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.18
published under the project's GitHub account · checked 21 Nov
Enable Zstandard response compression with USE_ZSTD, preferred over Brotli and gzip when the client accepts it; enabling it can also add Vary: Accept-Encoding to eligible uncompressed, gzip, and Brotli responses. Not checked yet Set DNSBL_LIST per service so individual services can override the global DNS blocklist; services without an override keep the global list. Not checked yet Output the current ban list as JSON for scripts and monitoring with bwcli bans --json. Not checked yet Control how often URL lists are refreshed in the blacklist, greylist, and whitelist plugins with the new *_URLS_REFRESH_INTERVAL settings (default 1h). Not checked yet Restrict antibot challenges to specific URIs with the new ANTIBOT_INCLUDE_URI setting; ANTIBOT_IGNORE_URI still takes precedence. Not checked yet
+11 more
show less
Write ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. audit log entries as JSON objects with the new MODSECURITY_SEC_AUDIT_LOG_FORMAT setting (Native or JSON). Not checked yet Run plugin code at the TLS ClientHello of every service through the new ssl_client_hello phase, ordered with PLUGINS_ORDER_SSL_CLIENT_HELLO. Not checked yet Size the CrowdSec decision and metadata caches with CROWDSEC_CACHE_SIZE (default 100m) and CROWDSEC_METADATA_CACHE_SIZE (default 5m). Not checked yet Limit BunkerNet reports to a fixed set of headers and blank matched values with BUNKERNET_FILTER_HEADERS, also applying retroactively to queued reports. Not checked yet Override CLIENT_HEADER_TIMEOUT and CLIENT_BODY_TIMEOUT on a per-service basis. Not checked yet Name a service by an IPv4 or IPv6 IPv6 The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. address with SERVER_NAME (e.g. SERVER_NAME=2001:db8::1); NGINX also matches the bracketed Host form. Not checked yet Use utils.add_ban with opts.if_absent for insert-only bans that never replace an existing ban, locally or in Redis. Not checked yet Export a support bundle with secrets redacted and IPs and domains anonymized using bwcli support. Not checked yet New floating Docker image tags 1.6-edge, 1.6-rc, 1.6-beta, and 1.6-alpha track the latest release candidate or release for each channel. Not checked yet The easy install script now routes downloads through HTTP_PROXY/HTTPS_PROXY and honours NO_PROXY. Not checked yet New login throttling in the UI counts failed logins per client IP and per username, locking them for 15 minutes after five failures in 15 minutes, configurable with LOGIN_THROTTLE, LOGIN_MAX_ATTEMPTS, LOGIN_WINDOW_MINUTES, and LOGIN_LOCKOUT_MINUTES. Not checked yet
16 details in Everything
└──▷ BREAKING ON UPGRADE
! BunkerWeb ModSecurity rules move to IDs 9,800,000-9,809,999; custom exclusions referencing old IDs must be updated (mapping in the docs).! Stream upstream TLS settings (REVERSE_PROXY_SSL_VERIFY=yes, protocols, ciphers, cached client certificate) now enable TLS to the backend instead of being ignored; clear them for a plaintext backend.! Setting regexes are stricter: list values joined without a separator (e.g. 404500) and all-space values are refused; AUTH_BASIC_USER is now wider and accepts any value without :.! The Lua API disk fallback now requires an explicit API_TOKEN line in variables.env; a file without one is refused.
BunkerWeb 1.6.17 adds IP-address TLS certificates, new database timeout settings, bad-behavior report size controls, and a shared-memory zone size knob for dynamic upstreams.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Prevent a stale MySQL connection from hanging the scheduler indefinitely by capping connect and read waits.
env
copy
DATABASE_CONNECT_TIMEOUT=5s
DATABASE_READ_TIMEOUT=30s
Limit how much memory bad-behavior ban reports consume when logging high-volume attack traffic.
env
copy
BAD_BEHAVIOR_REPORT_MAX_EVENTS=50
BAD_BEHAVIOR_REPORT_MAX_STRING_SIZE=512
Adds BAD_BEHAVIOR_REPORT_MAX_EVENTS config key to cap the number of new events copied as ban evidence into bad-behavior reports.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds BAD_BEHAVIOR_REPORT_MAX_STRING_SIZE config key to cap the maximum byte length of each URL or method string stored in bad-behavior reports. Not checked yet Adds DATABASE_CONNECT_TIMEOUT config key to set the maximum wait time when opening a connection to a MySQL, MariaDB, or PostgreSQL server; accepts a time suffix (ms, s, m, h, d, w, M, y). Not checked yet Adds DATABASE_READ_TIMEOUT config key to set the maximum wait time for a response from a MySQL or MariaDB server before failing (PostgreSQL uses TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. keepalives instead); accepts a time suffix (ms, s, m, h, d, w, M, y). Not checked yet Adds LOADBALANCER_ZONE_SIZE config key to control the shared memory zone size for upstreams with dynamic resolution. Not checked yet
+2 more
show less
Supports Let's Encrypt certificates for public IPv4 addresses: add the IP alongside hostnames in the server name field and BunkerWeb requests a single certificate covering all entries; IP certificates have 160-hour validity and are auto-renewed daily. Not checked yet ACME ACME An IETF-standard protocol (RFC 8555) for automating TLS certificate issuance and renewal, letting cyber tools manage certificates without manual CA interaction. HTTP-01 HTTP-01 An ACME protocol challenge type, defined by the IETF, where a CA verifies domain ownership by fetching a token over plain HTTP on port 80. Cyber tools use it to automate TLS certificate issuance. challenge URIs now pass through automatically, bypassing antibot, blacklist, rate limiting, Basic Auth, ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. , and the ban check, so Let's Encrypt validation succeeds even with those protections active. Not checked yet
Adds BAD_BEHAVIOR_REPORT_MAX_EVENTS config key to cap the number of new events copied as ban evidence into bad-behavior reports.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds BAD_BEHAVIOR_REPORT_MAX_STRING_SIZE config key to cap the maximum byte length of each URL or method string stored in bad-behavior reports. Not checked yet Adds DATABASE_CONNECT_TIMEOUT config key to set the maximum wait time when opening a connection to a MySQL, MariaDB, or PostgreSQL server; accepts a time suffix (ms, s, m, h, d, w, M, y). Not checked yet Adds DATABASE_READ_TIMEOUT config key to set the maximum wait time for a response from a MySQL or MariaDB server before failing (PostgreSQL uses TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. keepalives instead); accepts a time suffix (ms, s, m, h, d, w, M, y). Not checked yet Adds LOADBALANCER_ZONE_SIZE config key to control the shared memory zone size for upstreams with dynamic resolution. Not checked yet
+1 more
show less
Supports Let's Encrypt certificates for public IPv4 addresses: add the IP alongside hostnames in the server name field and BunkerWeb requests a single certificate covering all entries; IP certificates have 160-hour validity and are auto-renewed daily. Not checked yet
1 more in Everything
BunkerWeb: Supports Let's Encrypt certificate profiles, including short-lived (shortlived, 160-hour validity, up to 25 names).
└──▷ USE IT
Set database connection and read timeouts so a lost MySQL peer does not hang BunkerWeb indefinitely.
/etc/bunkerweb/variables.env
copy
DATABASE_CONNECT_TIMEOUT=5s
DATABASE_READ_TIMEOUT=10s
Request a Let's Encrypt certificate that covers both a hostname and a public IPv4 address in single-site mode.
/etc/bunkerweb/variables.env
copy
SERVER_NAME="www.example.com 203.0.113.10"
MULTISITE=no
Cap ban-evidence report size to control storage growth when bad-behavior events are frequent.
/etc/bunkerweb/variables.env
copy
BAD_BEHAVIOR_REPORT_MAX_EVENTS=50
BAD_BEHAVIOR_REPORT_MAX_STRING_SIZE=512
└──▷ USE IT
Set a 5-second connection timeout and a 30-second read timeout for a MariaDB backend so a vanished peer never blocks BunkerWeb indefinitely.
ini
copy
DATABASE_CONNECT_TIMEOUT=5s
DATABASE_READ_TIMEOUT=30s
Cap ban-report evidence to the 20 most recent events, each URL or method stored up to 512 bytes, to control report storage growth.
ini
copy
BAD_BEHAVIOR_REPORT_MAX_EVENTS=20
BAD_BEHAVIOR_REPORT_MAX_STRING_SIZE=512
BunkerWeb v1.6.17 adds configurable database timeouts and expands the default Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. to block unbounded-element.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.17 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.17
└──▷ USE IT
Reduce the database connect timeout in a high-availability environment where a dead DB node should be detected and bypassed quickly.
ini
copy
DATABASE_CONNECT_TIMEOUT=3s
DATABASE_READ_TIMEOUT=1m
Expands the default PERMISSIONS_POLICY header to also deny unbounded-element.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
1 detail in Everything
api-docs-9bb6ac79a8c8
Oct 16, 2026
·
issue 110
BunkerWeb 1.6.16 adds ban removal API supporting CrowdSec decision deletion via remove_crowdsec_decisions and decision_keys︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Remove a CrowdSec ban and delete the underlying CrowdSec decisions in one API call, preventing re-ban on the next sync.
copy
$ curl -X DELETE https://<bunkerweb-api>/bans \
-H 'Content-Type: application/json' \
-d '{"kind": "crowdsec_lease", "remove_crowdsec_decisions": true, "confirmed": true, "decision_keys": ["<key1>", "<key2>"]}'
BunkerWeb adds a plugin system with 12 official plugins (Authentik, ClamAV, Cloudflare, Coraza, open-appsec, SentinelOne, VirusTotal, and more) installable via EXTERNAL_PLUG︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Auto-install all official BunkerWeb plugins at startup by pointing EXTERNAL_PLUGIN_URLS at the versioned release ZIP.
text
copy
EXTERNAL_PLUGIN_URLS=https://github.com/bunkerity/bunkerweb-plugins/archive/refs/tags/v1.13.zip
Declare a new plugin with a scheduled hourly job and a custom setting in plugin.json.
myplugin/plugin.json
copy
{
"id": "myplugin",
"name": "My Plugin",
"description": "Just an example plugin.",
"version": "1.0",
"stream": "partial",
"settings": {
"DUMMY_SETTING": {
"context": "multisite",
"default": "1234",
"help": "Here is the help of the setting.",
"id": "dummy-id",
"label": "Dummy setting",
"regex": "^.*$",
"type": "text"
}
},
"jobs": [
{
"name": "my-job",
"file": "my-job.py",
"every": "hour"
}
]
}
Manually deploy plugins on a Linux host so BunkerWeb picks them up on next reload.
copy
$ git clone https://github.com/bunkerity/bunkerweb-plugins && \
cp -rp ./bunkerweb-plugins/* /etc/bunkerweb/plugins && \
chown -R nginx:nginx /etc/bunkerweb/plugins
Adds EXTERNAL_PLUGIN_URLS setting to automatically install one or more plugins from space-separated ZIP archive URLs at startup.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Introduces a plugin system supporting custom NGINX configs (confs/), Lua code (plugin.lua), scheduler jobs (jobs/), UI pages (ui/template.html), Flask hooks (ui/hooks.py), Flask blueprints (ui/blueprints/), and custom templates (templates/my-template.json), all declared in plugin.json. Not checked yet Adds bwcli field in plugin.json to map CLI command names to files in the plugin's bwcli/ directory, enabling CLI-accessible plugin commands. Not checked yet Ships 12 official plugins: Authentik (SSO SSO Single sign-on, using one identity provider to sign in to multiple applications. It reduces separate passwords and centralizes account and access management. forward-auth), ClamAV (file upload AV scanning), Cloudflare (trusted IPs, Origin CA, IP-list sync), Coraza (WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. , ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. alternative), Discord/Slack/Matrix/WebHook (security alert notifications), open-appsec (ML-based WAF via sidecar), SentinelOne (file hash and IP reputation blocking), SysWarden (nftables kernel-level block sync), and VirusTotal (file hash and IP reputation blocking). Not checked yet Supports manual plugin installation into /data/plugins (Docker/Swarm/Kubernetes via volume mount) or /etc/bunkerweb/plugins (Linux integration). Not checked yet
5 details in Everything
BunkerWeb 1.6.16 adds keepalived VRRP VRRP A network protocol (RFC 5798) that lets multiple routers share a virtual IP address, electing one as active so hosts keep a working gateway if the primary fails. active/passive HA and a smarter healthcheck that stays ok during config reloads.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Configure keepalived on the master worker to use the BunkerWeb healthcheck, so VRRP only holds the VIP VIP A Virtual IP address — a single IP shared across multiple hosts or services, commonly used for load balancing or failover so traffic can be rerouted without changing the client-facing address. while NGINX is healthy — reloads no longer trigger a false failover.
/etc/keepalived/keepalived.conf
copy
global_defs {
enable_script_security
script_user root
}
vrrp_script chk_bunkerweb {
script "/usr/share/bunkerweb/helpers/healthcheck.sh ok"
interval 2
fall 2
rise 2
}
vrrp_instance VI_BUNKERWEB {
state MASTER
interface eth0
virtual_router_id 51
priority 110
advert_int 1
authentication {
auth_type PASS
auth_pass changeme
}
virtual_ipaddress {
192.168.10.100/24
}
track_script {
chk_bunkerweb
}
}
Adds healthcheck.sh ok argument to /usr/share/bunkerweb/helpers/healthcheck.sh so the health endpoint returns success during config reloads (when NGINX is still serving the previous config), exiting non-zero only when the instance is still in loading state or NGINX is stopped.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds documented keepalived VRRP active/passive HA topology (section 6) using /etc/keepalived/keepalived.conf with vrrp_script chk_bunkerweb calling healthcheck.sh ok, enabling sub-10-second failover between BunkerWeb workers without a load balancer. Not checked yet Documents shared-state guidance for active/passive HA: enable Redis (USE_REDIS) on both workers and set identical fixed values for SESSIONS_SECRET and SESSIONS_NAME via global Manager settings to preserve locks, counters, and sessions across failover. Not checked yet
3 details in Everything
BunkerWeb adds TLS-handshake dropping for banned IPs (BANS_TLS_DROP_REASONS), configurable PoW difficulty (ANTIBOT_JAVASCRIPT_DIFFICULTY), and a -confirm flag for bwcli unban.
Adds BANS_TLS_DROP_REASONS to close connections at the TLS handshake for chosen ban reasons (bad_behavior, manual, ui, api), saving CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. ; never applies to HTTP/3 HTTP/3 The third major version of HTTP, standardized by the IETF, which runs over QUIC instead of TCP, eliminating head-of-line blocking and reducing connection latency for faster, more resilient data transfer. . Not checked yet Adds ANTIBOT_JAVASCRIPT_DIFFICULTY (16–28 leading zero-bits, default 16) to control JavaScript Proof-of-Work challenge cost. Not checked yet Updated integration Extends bwcli unban with -confirm to preview CrowdSec decision removal before committing. Not checked yet
3 details in Everything
Adds the openappsec external plugin to route requests through the open-appsec machine-learning WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. sidecar agent for blocking.
BunkerWeb 1.6.16 adds active/passive high-availability via keepalived keepalived A Linux daemon that implements VRRP and health-check-driven load balancing to keep a virtual IP address available even when individual nodes fail, giving cyber tools a reliable, self-healing network endpoint without external orchestration. with VRRP VRRP A network protocol (RFC 5798) that lets multiple routers share a virtual IP address, electing one as active so hosts keep a working gateway if the primary fails. -based VIP VIP A Virtual IP address — a single IP shared across multiple hosts or services, commonly used for load balancing or failover so traffic can be rerouted without changing the client-facing address. failover for multi-worker deployments.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Configure keepalived health-check on the master worker so the VIP is only held when BunkerWeb is fully ready — not during config reload.
/etc/keepalived/keepalived.conf
copy
vrrp_script chk_bunkerweb {
script "/usr/share/bunkerweb/helpers/healthcheck.sh ok"
interval 2
fall 2
rise 2
}
vrrp_instance VI_BUNKERWEB {
state MASTER
interface eth0
virtual_router_id 51
priority 110
advert_int 1
authentication {
auth_type PASS
auth_pass changeme
}
virtual_ipaddress {
192.168.10.100/24
}
track_script {
chk_bunkerweb
}
}
Verify BunkerWeb is fully operational (not just loading) before keepalived promotes the worker — use in scripts or manual checks.
copy
$ /usr/share/bunkerweb/helpers/healthcheck.sh ok
Adds keepalived active/passive HA mode using VRRP virtual IP (VIP) failover as a load-balancer-free alternative to multi-worker deployments, configured via /etc/keepalived/keepalived.conf.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds ok argument to /usr/share/bunkerweb/helpers/healthcheck.sh to return exit code 0 only when the instance is fully ready (NGINX running and configuration applied), enabling keepalived to withhold the VIP from instances still in loading state. Not checked yet Supports shared ban/counter state across HA workers by pointing both workers at the same Redis/Valkey instance via the Redis settings. Not checked yet
Adds keepalived active/passive HA mode using VRRP virtual IP (VIP) failover as a load-balancer-free alternative to multi-worker deployments, configured via /etc/keepalived/keepalived.conf.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds ok argument to /usr/share/bunkerweb/helpers/healthcheck.sh to return exit code 0 only when the instance is fully ready (NGINX running and configuration applied), enabling keepalived to withhold the VIP from instances still in loading state. Not checked yet
1 more in Everything
Adds BANS_TLS_DROP_REASONS to terminate banned IPs at TLS handshake, CROWDSEC_BAN_REFRESH for native short-lived CrowdSec bans, ANTIBOT_JAVASCRIPT_DIFFICULTY for PoW tuning, and JSON fragment filters for list sources.
Adds BANS_TLS_DROP_REASONS config key to drop banned clients at TLS negotiation (before certificate or key-exchange work) for specified ban reasons (bad_behavior, manual, ui, api, space-separated); default is empty, preserving the 403 page for all bans — saves CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. when banned IPs repeatedly reconnect. Not checked yet Adds ANTIBOT_JAVASCRIPT_DIFFICULTY config key to tune proof-of-work challenge difficulty in bits of leading zeros (range 16–28, default 16); each additional bit doubles average solve time. Not checked yet Adds JSON fragment filter syntax for IP/URL list sources: #key keeps values under a key, #key=value keeps objects whose property equals or contains a value, and & combines terms (e.g. https://ip-ranges.amazonaws.com/ip-ranges.json#service=CLOUDFRONT). Not checked yet Tracks TLS-drop counts per ban reason in metrics, and exposes ban state plus CrowdSec ban state in the bans_meta shared-memory zone (always declared at 10 MiB, memory used only when BANS_TLS_DROP_REASONS or CROWDSEC_BAN_REFRESH is set). Not checked yet Updated integration Extends bwcli unban with a -confirm flag for CrowdSec ban removal: without -confirm the command lists affected CrowdSec decisions (IP/range, type, origin, scenario) without deleting anything; with -confirm it removes CrowdSec decisions and the BunkerWeb ban together. Not checked yet
+1 more
show less
Supports duration suffixes (ms, s, m, h, d, w, M, y) on all time-based config keys including CROWDSEC_BAN_REFRESH, ANTIBOT_JAVASCRIPT_DIFFICULTY timeouts, CORS CORS A browser mechanism that lets a server declare which foreign origins may read its HTTP responses, enforced by the browser to block unauthorized cross-site requests from JavaScript. preflight cache, and UI session retention. Not checked yet
6 details in Everything
BunkerWeb adds an open-appsec ML-WAF ML-WAF A web application firewall that uses machine learning models to detect and block malicious HTTP traffic, letting cyber tools adapt to novel attack patterns without relying solely on static signature rules. sidecar plugin, installable via EXTERNAL_PLUGIN_URLS pointing to the v1.13 plugin archive.
BunkerWeb: Adds floating-IP high availability via keepalived keepalived A Linux daemon that implements VRRP and health-check-driven load balancing to keep a virtual IP address available even when individual nodes fail, giving cyber tools a reliable, self-healing network endpoint without external orchestration. VRRP VRRP A network protocol (RFC 5798) that lets multiple routers share a virtual IP address, electing one as active so hosts keep a working gateway if the primary fails. , so workers run active/passive without a load balancer; the VIP VIP A Virtual IP address — a single IP shared across multiple hosts or services, commonly used for load balancing or failover so traffic can be rerouted without changing the client-facing address. fails over in ~4 seconds on container stop.
└──▷ USE IT
Configure keepalived on the master worker so the VIP floats to the backup only when BunkerWeb is genuinely healthy and fully configured.
/etc/keepalived/keepalived.conf
copy
global_defs {
enable_script_security
script_user root
}
vrrp_script chk_bunkerweb {
script "/usr/share/bunkerweb/helpers/healthcheck.sh ok"
interval 2
fall 2
rise 2
}
vrrp_instance VI_BUNKERWEB {
state MASTER
interface eth0
virtual_router_id 51
priority 110
advert_int 1
authentication {
auth_type PASS
auth_pass changeme
}
virtual_ipaddress {
192.168.10.100/24
}
track_script {
chk_bunkerweb
}
}
Documents /etc/keepalived/keepalived.conf configuration for BunkerWeb workers, using vrrp_script chk_bunkerweb with interval 2, fall 2, rise 2 to gate VIP ownership on the healthcheck result. Not checked yet
1 detail in Everything
└──▷ USE IT
Drop manually banned and bad-behavior IPs at the TLS layer to avoid serving a 403 page to repeat offenders, reducing CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. cost on high-volume ban lists.
env
copy
BANS_TLS_DROP_REASONS=bad_behavior manual
Convert CrowdSec blocks into 5-minute BunkerWeb bans so repeat offenders are stopped at the ban check rather than triggering a live CrowdSec API lookup on every request.
env
copy
CROWDSEC_BAN_REFRESH=5m
BunkerWeb v1.6.16 adds Redis Cluster Redis Cluster A distributed mode of Redis, the open-source in-memory data store, that automatically shards data across multiple nodes and keeps it available if some nodes fail, giving cyber tools low-latency shared state at scale. support, TLS-drop banning, IPv4 Let's Encrypt certs, and richer IP-list formats.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.16 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.16
└──▷ USE IT
Enable Redis Cluster for BunkerWeb to share state across a multi-node cluster instead of a single Redis instance.
text
copy
REDIS_CLUSTER_NODES=redis-node1:6379,redis-node2:6379,redis-node3:6379
Drop TLS connections from banned IPs at the handshake level (for captcha and manual bans) so banned clients never see an HTTP response.
env
copy
BANS_TLS_DROP_REASONS=captcha,manual
Increase the JavaScript antibot challenge difficulty to slow down automated solvers without changing the challenge page.
env
copy
ANTIBOT_JAVASCRIPT_DIFFICULTY=24
Adds REDIS_CLUSTER_NODES setting to enable Redis Cluster support for the redis integration.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds BANS_TLS_DROP_REASONS to close TLS handshakes of banned IPs for specified ban reasons instead of serving a 403 page, including dropping banned clients at the TLS ClientHello TLS ClientHello The first message a TLS client sends when opening an encrypted connection, advertising supported cipher suites, TLS versions, and extensions. Cyber tools inspect or forge it to fingerprint clients or intercept traffic. behind PROXY protocol when real IP uses proxy_protocol (trusted only from proxies in REAL_IP_FROM). Not checked yet Adds CROWDSEC_BAN_REFRESH to turn CrowdSec blocks into short, renewed bans listed on the Bans page and removed with their decisions on Unban. Not checked yet Adds ANTIBOT_JAVASCRIPT_DIFFICULTY (16 to 28 bits) to raise the JavaScript proof-of-work challenge cost in the antibot plugin. Not checked yet Supports Let's Encrypt certificates for public IPv4 addresses in SERVER_NAME using the shortlived profile and the http challenge. Not checked yet
+5 more
show less
Extends IP list URL support in realip, blacklist, whitelist, and greylist to include JSON, JSON lines, CSV, and tab-separated formats, with a #key=value filter. Not checked yet Adds an admin-only Web UI Diagnostics bundle on the Support page (/support/logs), with IPv6 IPv6 The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. address and credential anonymization. Not checked yet Redesigns antibot challenge pages to follow browser preferences (theme, reduced motion, contrast, and text size), with a discreet reload link. Not checked yet Adds publickey-credentials-remote-client-data-json denial to the default PERMISSIONS_POLICY header in the headers plugin. Not checked yet Allows a scheduler job to exit with code 3 to request a configuration reload while still being reported as failed. Not checked yet
Adds REDIS_CLUSTER_NODES setting to enable Redis Cluster support for the redis integration.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds BANS_TLS_DROP_REASONS to close TLS handshakes of banned IPs for specified ban reasons instead of serving a 403 page, including dropping banned clients at the TLS ClientHello TLS ClientHello The first message a TLS client sends when opening an encrypted connection, advertising supported cipher suites, TLS versions, and extensions. Cyber tools inspect or forge it to fingerprint clients or intercept traffic. behind PROXY protocol when real IP uses proxy_protocol (trusted only from proxies in REAL_IP_FROM). Not checked yet Adds CROWDSEC_BAN_REFRESH to turn CrowdSec blocks into short, renewed bans listed on the Bans page and removed with their decisions on Unban. Not checked yet Adds ANTIBOT_JAVASCRIPT_DIFFICULTY (16 to 28 bits) to raise the JavaScript proof-of-work challenge cost in the antibot plugin. Not checked yet Supports Let's Encrypt certificates for public IPv4 addresses in SERVER_NAME using the shortlived profile and the http challenge. Not checked yet
+2 more
show less
Adds an admin-only Web UI Diagnostics bundle on the Support page (/support/logs), with IPv6 IPv6 The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. address and credential anonymization. Not checked yet Allows a scheduler job to exit with code 3 to request a configuration reload while still being reported as failed. Not checked yet
3 more in Everything
└──▷ BREAKING ON UPGRADE
! METRICS_REDIS_TTL now interprets m as minutes instead of millions; values stored in the database are migrated automatically, but values set through environment variables are not and must be updated manually.
BunkerWeb gains a guided install-bunkerweb.sh --docker upgrade path with automatic backup, health checks, and rollback for Docker stacks.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Upgrade while preserving local docker-compose.yml edits but skip pulling images (useful when images are pre-pulled in an air-gapped environment).
copy
$ bash install-bunkerweb.sh --docker --compose-dir /opt/bunkerweb -v 1.6.15 --no-pull
Force-regenerate docker-compose.yml when switching stack topology (e.g. from all-in-one to split manager/worker), accepting the destructive topology change.
copy
$ bash install-bunkerweb.sh --docker --compose-dir /opt/bunkerweb -v 1.6.15 --overwrite-compose --force-type-change
Adds --compose-dir PATH flag to install-bunkerweb.sh --docker to specify the stack directory instead of defaulting to the current working directory.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds -v, --version VERSION flag to target a specific BunkerWeb version during upgrade, deriving the image tag automatically. Not checked yet Adds --image-tag TAG flag to supply a Docker image tag directly instead of deriving it from a version string. Not checked yet Adds --backup-dir PATH flag to set a custom destination for the pre-upgrade backup archive. Not checked yet Adds --overwrite-compose flag to force regeneration of docker-compose.yml even when local edits are detected. Not checked yet
+8 more
show less
Adds --force-type-change flag to allow switching stack topology (destructive) during an upgrade. Not checked yet Adds --no-pull flag to skip pulling new images before container recreation. Not checked yet Adds --docker-wait-timeout N flag to control how many seconds the script waits for the stack to become healthy (default: 600). Not checked yet Upgrade script now runs bwcli plugin backup save in the Scheduler container and copies the archive to the host before applying any changes, aborting if the backup fails unless overridden. Not checked yet Upgrade script reads the running version from the live container rather than trusting the image tag, enabling reliable detection of rolling tags (latest, testing) and previously interrupted upgrades. Not checked yet Upgrade script rewrites .env with the new image tag while preserving manually added entries, and recreates docker-compose.yml only when it matches the script-generated original — local edits are kept unless --overwrite-compose is passed. Not checked yet Upgrade script performs post-upgrade health verification requiring two healthy observations at least ten seconds apart before reporting success, and exits with status 2 (without rollback) if the stack does not become healthy within the timeout. Not checked yet Adds replay protection for two-factor authentication codes stored in the shared database across Web UI replicas. Not checked yet
13 details in Everything
BunkerWeb UI gains Redis-resilient session fallback with UI_USE_REDIS, per-service draft mode in the RAW editor, and scoped role controls.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Disable Redis for the BunkerWeb UI session store only, keeping Redis active for inter-instance lock and report sharing.
Adds UI_USE_REDIS=no config variable to decouple the web UI from Redis independently of the global USE_REDIS setting, so Redis can be disabled for session storage without also disabling lock and report sharing between instances.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds Redis-resilient session storage: when Redis is unavailable or rejects writes due to maxmemory, UI sessions fall back to a local per-host cache, with revocations (including logout and session-ID rotation) recorded in both stores to ensure they take effect regardless of Redis state. Not checked yet Adds draft mode in the RAW editor for services and global settings: prefix a KEY=value line with # to mark it as a draft (value stored but not applied), or press Backspace on a draft line to activate it; draft lines persist across saves until explicitly activated. Not checked yet
Adds UI_USE_REDIS=no config variable to decouple the web UI from Redis independently of the global USE_REDIS setting, so Redis can be disabled for session storage without also disabling lock and report sharing between instances.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds draft mode in the RAW editor for services and global settings: prefix a KEY=value line with # to mark it as a draft (value stored but not applied), or press Backspace on a draft line to activate it; draft lines persist across saves until explicitly activated. Not checked yet
1 more in Everything
BunkerWeb adds CrowdSec management APIs, header-based bypass rules, and session revocation memory config across multiple modules.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Allow an internal health-check service to bypass the antibot challenge by presenting a shared secret header.
env
copy
ANTIBOT_IGNORE_HEADER_NAME_1=X-Internal-Token
ANTIBOT_IGNORE_HEADER_VALUE_1=^my-secret-token$
Investigate all active CrowdSec decisions for a specific IP across a connection, to confirm whether a block is still in force before escalating a support ticket.
copy
$ curl -s -H 'Authorization: Bearer <api_token>' 'https://bunkerweb.example.com/api/crowdsec/<connection_id>/ips/203.0.113.42'
Remove a mistaken CrowdSec ban on an IP so it propagates to all bouncers at their next stream update.
copy
$ curl -s -X DELETE -H 'Authorization: Bearer <api_token>' -H 'Content-Type: application/json' -d '{"scope":"ip","value":"203.0.113.42","decision_type":"ban"}' 'https://bunkerweb.example.com/api/crowdsec/<connection_id>/decisions/<decision_id>'
Adds SESSIONS_REVOCATION_MEMORY_SIZE config key to control the in-memory store size for revoked cookie session identifiers.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds ANTIBOT_IGNORE_HEADER_NAME and ANTIBOT_IGNORE_HEADER_VALUE config keys (numbered pairs _NAME_1/_VALUE_1) to allow requests matching a named header and optional PCRE PCRE A widely used open-source regular expression library, maintained by the PCRE project, that gives tools Perl-compatible pattern matching without depending on Perl itself. regex to bypass the antibot challenge. Not checked yet Adds BLACKLIST_HEADER_NAME and BLACKLIST_HEADER_VALUE config keys (numbered pairs) to blacklist requests carrying a specific header and optional PCRE-matched value. Not checked yet Adds BLACKLIST_IGNORE_HEADER_NAME and BLACKLIST_IGNORE_HEADER_VALUE config keys (numbered pairs) to exempt requests matching a named header from the blacklist, overriding any cached blacklist hit. Not checked yet Adds COUNTRY_IGNORE_HEADER_NAME and COUNTRY_IGNORE_HEADER_VALUE config keys (numbered pairs) to allow requests matching a named header to bypass country-based blocking. Not checked yet
+10 more
show less
Adds CROWDSEC_MANAGEMENT_LOGIN and CROWDSEC_MANAGEMENT_PASSWORD config keys to enable CrowdSec decision removal and alert inspection via a dedicated registered machine identity. Not checked yet Adds GET /crowdsec API endpoint to retrieve CrowdSec connection status, sync state, and errors per instance. Not checked yet Adds GET /crowdsec/{connection_id}/decisions API endpoint to list decisions, filterable by origin and scenario, paginated with offset and limit (max 200). Not checked yet Adds GET /crowdsec/{connection_id}/ips/{ip} API endpoint for IP investigation returning up to 200 decisions, 50 alerts, and 50 reports including totals. Not checked yet Adds GET /crowdsec/{connection_id}/alerts/{alert_id} API endpoint to retrieve sanitized alert details. Not checked yet Adds GET /crowdsec/{connection_id}/allowlists API endpoint to list native CrowdSec allowlists with entries, comments, expiry, and management origin, paginated with offset and limit (up to 200 entries per list). Not checked yet Adds GET /crowdsec/{connection_id}/allowlists/check?ip={ip} API endpoint to check whether an IP is on a native CrowdSec allowlist and return the match reason. Not checked yet Adds DELETE /crowdsec/{connection_id}/decisions/{decision_id} API endpoint to remove a CrowdSec decision, requiring scope, value, and decision_type in the JSON request body. Not checked yet Introduces crowdsec_read and crowdsec_delete delegated API permissions under the existing bans resource, scoped to a connection ID or *, distinct from the existing ban_delete permission. Not checked yet Adds a CrowdSec investigation UI under Additional Pages → CrowdSec that consolidates active decisions, alerts, BunkerWeb reports, local bans, and native allowlist status with pre-filled IP lookup links. Not checked yet
15 details in Everything
BunkerWeb adds SentinelOne, SysWarden, and VirusTotal integrations plus ClamAV antivirus file scanning︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Install the full v1.12 plugin bundle — including SentinelOne, SysWarden, ClamAV, and VirusTotal — by pointing the scheduler at the tagged archive.
text
copy
EXTERNAL_PLUGIN_URLS=https://github.com/bunkerity/bunkerweb-plugins/archive/refs/tags/v1.12.zip
Adds EXTERNAL_PLUGIN_URLS config key supporting https://github.com/bunkerity/bunkerweb-plugins/archive/refs/tags/v1.12.zip to install the new plugin bundle.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds bunkerweb-plugins/sentinelone plugin to check uploaded file hashes and client IPs against the SentinelOne API, blocking requests based on reputation or indicators of compromise indicators of compromise An indicator of compromise, an observable clue that may point to malicious activity, such as a suspicious file hash or domain. It is evidence to investigate, rather than proof by itself. . Not checked yet Adds bunkerweb-plugins/syswarden plugin to synchronize BunkerWeb bans to SysWarden for kernel-level nftables blocking and import its block/allow lists. Not checked yet Adds ClamAV antivirus plugin that automatically scans uploaded files and rejects requests when a file is detected as malicious. Not checked yet Adds VirusTotal plugin to check uploaded file hashes and client IPs against the VirusTotal API, blocking requests when configured reputation thresholds are exceeded. Not checked yet
5 details in Everything
BunkerWeb: The install script rewrites .env with the new image tag while preserving any manually added entries, and backs up both .env and docker-compose.yml with a .bak.<timestamp> copy before making changes.
└──▷ TRY IT
Upgrade a stack that lives outside the current directory to a specific version, with a custom backup destination and an extended health-check timeout for slow first starts.
copy
$ bash install-bunkerweb.sh --docker --compose-dir /opt/bunkerweb --version 1.6.15 --backup-dir /mnt/backups --docker-wait-timeout 900
Force regeneration of a locally modified docker-compose.yml when the local edits are no longer needed and you want the script-generated layout back.
copy
$ bash install-bunkerweb.sh --docker --compose-dir /opt/bunkerweb --version 1.6.15 --overwrite-compose
The upgrade process runs docker compose pull then docker compose up -d, recreating only containers whose image changed, and requires two healthy observations at least ten seconds apart before declaring success. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! Two-factor authentication anti-replay state is now stored in the shared database instead of per-replica memory; during a rolling upgrade, a TOTP TOTP A one-time password algorithm (RFC 6238) that generates short-lived codes from a shared secret and the current time, giving cyber tools phishing-resistant second-factor authentication without a server round-trip. code already displayed may be rejected for up to 33 seconds — upgrade all web UI replicas simultaneously to minimise the window. TOTP encryption keys must remain available to every replica as before.
└──▷ USE IT
Isolate the UI from Redis session storage without disabling Redis-backed bannishments and inter-instance reporting — useful when you want Redis for data sharing but local session handling.
Stage a config change in the RAW editor without applying it yet — useful for preparing a value to activate in a single future save.
📍 # In the BunkerWeb web UI RAW editor:
# 1. Open a service or global settings RAW editor.
# 2. Place the cursor at the start of a KEY=value line.
# 3. Press # to toggle the line into draft state (line becomes highlighted).
# 4. Save — the value is stored but the effective config remains unchanged.
# 5. Press Backspace on the draft line (or # again) to activate, then save to apply.
BunkerWeb: Adds a Pages supplémentaires → CrowdSec UI page showing connection status, local API connectivity, decision synchronisation, allowlist entries, and IP investigation with pre-filled addresses from Reports and Bans pages.
└──▷ TRY IT
Remove an active CrowdSec ban from the local API without touching BunkerWeb-local bans — useful when a decision was issued in error on a shared engine.
copy
$ curl -X DELETE https://bunkerweb.example.com/crowdsec/<connection_id>/decisions/<decision_id> \
-H 'Authorization: Bearer <api_token>' \
-H 'Content-Type: application/json' \
-d '{"scope": "ip", "value": "203.0.113.42", "decision_type": "ban"}'
Investigate all active CrowdSec decisions for a suspicious IP, including matching alerts and retained BunkerWeb reports, to triage an incident.
copy
$ curl -s 'https://bunkerweb.example.com/crowdsec/<connection_id>/ips/203.0.113.42' \
-H 'Authorization: Bearer <api_token>' | jq .
Allow internal monitoring probes to skip the antibot challenge by presenting a shared secret header, without opening access to all traffic.
ini
copy
ANTIBOT_IGNORE_HEADER_NAME_1=X-Internal-Token
ANTIBOT_IGNORE_HEADER_VALUE_1=^my-secret-rotation-value$
BunkerWeb: The all-in-one upgrade script auto-detects install type, secrets, host ports, worker list, and Compose project name from .env, preventing accidental credential rotation or port changes on upgrade.
└──▷ BREAKING ON UPGRADE
! Two-factor authentication replay protection is now stored in the shared database and only covers replicas running this version; during a mixed-version migration window an already-displayed TOTP TOTP A one-time password algorithm (RFC 6238) that generates short-lived codes from a shared secret and the current time, giving cyber tools phishing-resistant second-factor authentication without a server round-trip. code may be rejected for up to 33 seconds.
└──▷ USE IT
Isolate the UI's Redis dependency from the rest of BunkerWeb — useful when you want bans and reports shared via Redis but need the UI to run without it.
Prepare a config change in the RAW editor without applying it yet — stage it as a draft and activate it in a later save when ready.
📍 In the RAW editor, place the cursor at the start of a KEY=value line and press # to toggle it to draft state. The line is highlighted and the value is stored but not applied. Press Backspace on the drafted line to activate it, then save to apply.
└──▷ USE IT
Allow a trusted internal service to bypass the antibot challenge by presenting a shared-secret header, while anchoring the regex so partial matches are rejected.
env
copy
ANTIBOT_IGNORE_HEADER_NAME_1=X-Internal-Token
ANTIBOT_IGNORE_HEADER_VALUE_1=^my-secret-token$
Programmatically remove a specific CrowdSec ban on an IP address via the public API, useful in an automated remediation workflow.
copy
$ curl -s -X DELETE https://bunkerweb.example.com/api/crowdsec/<connection_id>/decisions/<decision_id> \
-H 'Authorization: Bearer <api_token>' \
-H 'Content-Type: application/json' \
-d '{"scope": "ip", "value": "198.51.100.42", "decision_type": "ban"}'
Investigate a suspicious IP across all CrowdSec decisions, alerts, and retained BunkerWeb reports in one call.
copy
$ curl -s 'https://bunkerweb.example.com/api/crowdsec/<connection_id>/ips/198.51.100.42' \
-H 'Authorization: Bearer <api_token>'
BunkerWeb 1.6.15 adds per-setting draft mode in the RAW editor, letting you toggle individual settings without losing their inherited defaults.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ HOW TO FIND IT
Temporarily disable a setting in RAW mode without deleting it, so its inherited or default value applies while you keep the line for later activation.
📍 In the RAW mode editor, navigate to the start of a setting line and press # to mark it as draft. The line gains a muted # prefix and the inherited/default value takes effect. Press Backspace at the start of the line to reactivate it, then click Save to persist.
Adds per-setting draft mode in RAW mode: press # at the start of a setting line to toggle it to draft state (showing a muted # prefix), and press Backspace at the start to reactivate it; draft settings retain their inherited or default value until activated.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Draft settings are preserved when saving in Simple or Advanced mode, keeping editor metadata consistent across UI modes. Not checked yet
2 details in Everything
BunkerWeb 1.6.15 adds mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. to upstreams, per-header allow/block criteria, per-URL client size limits, and a syslog-ng syslog-ng An open-source log collector and router that ingests, filters, parses, and forwards log messages from many sources to many destinations, giving cyber tools a flexible, high-throughput pipeline for centralizing event data. UI log collector.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.15 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.15
└──▷ USE IT
Disable Redis for the Web UI only — keeping global ban and report sharing intact — when the UI workers are hitting Redis connection limits.
/etc/bunkerweb/variables.env
copy
UI_USE_REDIS=no
Send ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. concurrent audit log entries to a dedicated path for ingestion by a SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. , rather than the default log location.
/etc/bunkerweb/variables.env
copy
MODSECURITY_SEC_AUDIT_LOG=/var/log/bunkerweb/modsec_audit.log
Adds UI_USE_REDIS=no to disable Redis exclusively for the Web UI without disabling the global Redis-backed ban and report sharing.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds MODSECURITY_SEC_AUDIT_LOG to configure the ModSecurity audit log path under /var/log/bunkerweb. Not checked yet Adds per-URL REVERSE_PROXY_MAX_CLIENT_SIZE to control both request body size and the ModSecurity body-size limit on a per-location basis. Not checked yet Supports presenting a client certificate to upstreams for mutual TLS mutual TLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. in the reverseproxy and grpc plugins, with configurable upstream CRL CRL A Certificate Revocation List is a signed file, published by a certificate authority, listing certificates it has revoked before expiry so that clients can reject compromised or mis-issued credentials without contacting the CA live. , TLS protocols, and ciphers validated and distributed by the Scheduler. Not checked yet Adds header-based matching to antibot, blacklist, whitelist, greylist, dnsbl, and country plugins — match on a request header name and optional PCRE PCRE A widely used open-source regular expression library, maintained by the PCRE project, that gives tools Perl-compatible pattern matching without depending on Perl itself. value regex as an ignore or list criterion; header values are stored as password settings and are never logged or cached. Not checked yet
+7 more
show less
Expands the grpc plugin to match reverseproxy configurability, including client response headers, pass/ignore headers, underscores in headers, buffer and body-size controls, auth_request, and upstream TLS verification. Not checked yet Adds CrowdSec IP investigation, allowlist inspection, and decision removal through the Web UI and API, with richer report details and on-page allowlist guidance. Not checked yet Adds opt-in concurrent audit logging for ModSecurity with instance-side storage validation. Not checked yet Adds install-bunkerweb.sh --docker upgrade capability for Docker stacks previously generated by the installer, backing up the database and preserving secrets, ports, and Compose edits while refusing downgrades. Not checked yet Adds logrotate integration for the all-in-one image; mount /etc/logrotate.d/bunkerweb to provide a custom rotation policy. Not checked yet Adds destroyed-session rejection on next use, locally or cluster-wide when Redis is enabled. Not checked yet Allows individual settings to remain as drafts in the RAW editor, with explicit activation and inherited/default effective values. Not checked yet
Adds UI_USE_REDIS=no to disable Redis exclusively for the Web UI without disabling the global Redis-backed ban and report sharing.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds MODSECURITY_SEC_AUDIT_LOG to configure the ModSecurity audit log path under /var/log/bunkerweb. Not checked yet Adds per-URL REVERSE_PROXY_MAX_CLIENT_SIZE to control both request body size and the ModSecurity body-size limit on a per-location basis. Not checked yet Supports presenting a client certificate to upstreams for mutual TLS mutual TLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. in the reverseproxy and grpc plugins, with configurable upstream CRL CRL A Certificate Revocation List is a signed file, published by a certificate authority, listing certificates it has revoked before expiry so that clients can reject compromised or mis-issued credentials without contacting the CA live. , TLS protocols, and ciphers validated and distributed by the Scheduler. Not checked yet Adds header-based matching to antibot, blacklist, whitelist, greylist, dnsbl, and country plugins — match on a request header name and optional PCRE PCRE A widely used open-source regular expression library, maintained by the PCRE project, that gives tools Perl-compatible pattern matching without depending on Perl itself. value regex as an ignore or list criterion; header values are stored as password settings and are never logged or cached. Not checked yet
+5 more
show less
Adds opt-in concurrent audit logging for ModSecurity with instance-side storage validation. Not checked yet Adds install-bunkerweb.sh --docker upgrade capability for Docker stacks previously generated by the installer, backing up the database and preserving secrets, ports, and Compose edits while refusing downgrades. Not checked yet Adds logrotate integration for the all-in-one image; mount /etc/logrotate.d/bunkerweb to provide a custom rotation policy. Not checked yet Adds destroyed-session rejection on next use, locally or cluster-wide when Redis is enabled. Not checked yet Allows individual settings to remain as drafts in the RAW editor, with explicit activation and inherited/default effective values. Not checked yet
2 more in Everything
BunkerWeb 1.6.14 adds mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. CA bundle and CRL CRL A Certificate Revocation List is a signed file, published by a certificate authority, listing certificates it has revoked before expiry so that clients can reject compromised or mis-issued credentials without contacting the CA live. distribution via scheduler, plus Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. Client Hints controls
└──▷ USE IT
Supply a client CA bundle inline so the scheduler distributes it to all instances without mounting files into each container.
yaml
copy
MTLS_CA_CERTIFICATE_DATA: "<base64-or-PEM-encoded-CA-bundle>"
MTLS_CRL_DATA: "<base64-or-PEM-encoded-CRL>"
Re-allow device-pixel-ratio Client Hints after the new default Permissions-Policy blocks all ch-* directives, so responsive-image pipelines keep working.
yaml
copy
PERMISSIONS_POLICY: "accelerometer=(), ..., ch-dpr=(self)"
Adds MTLS_CA_CERTIFICATE_DATA config key to supply trusted client CA bundle inline as base64 or PEM (e.g. via Web UI), eliminating per-instance file mounts. Not checked yet Adds MTLS_CA_CERTIFICATE_PRIORITY config key to control priority of the client CA bundle source. Not checked yet Adds MTLS_CRL_DATA config key to supply a PEM-encoded certificate revocation list inline as base64 or PEM, enabling revoked-certificate rejection without file mounts. Not checked yet Adds MTLS_CRL_PRIORITY config key to control priority of the client CRL source. Not checked yet Scheduler now validates, caches, and distributes CA bundles and CRLs to every BunkerWeb instance automatically on each job run — no per-instance volume mounts required; reference a PEM file readable by the scheduler or pass data inline. Not checked yet
+3 more
show less
Incoming X-SSL-* request headers from clients are now stripped on every site regardless of whether mTLS is enabled, under HTTP/1.1, HTTP/2 HTTP/2 The second major version of the HTTP protocol, standardized by the IETF, adding multiplexed streams, header compression, and binary framing over a single TCP connection to cut latency and reduce overhead. , and HTTP/3 HTTP/3 The third major version of HTTP, standardized by the IETF, which runs over QUIC instead of TCP, eliminating head-of-line blocking and reducing connection latency for faster, more resilient data transfer. , preventing header spoofing (e.g. X-SSL-Client-Verify: SUCCESS). Not checked yet Default Permissions-Policy now blocks Client Hints (ch-* directives); adjust the policy to re-allow specific ch-* features (e.g. ch-dpr=(self)) for services relying on Accept-CH or Sec-CH-Prefers-Color-Scheme . Not checked yet Blocked-request report retention is documented as a rolling buffer: without Redis the cap is the buffer size multiplied by the number of NGINX workers per instance; with Redis the cap is a single shared limit. Reports are cleared on restart unless Redis is enabled and persistent; forward NGINX logs to a syslog server or SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. for long-term retention. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! The default Permissions-Policy now blocks all ch-* (Client Hints) directives; services relying on Accept-CH or Sec-CH-Prefers-Color-Scheme will lose Client Hints support until the policy is adjusted to re-allow the required ch-* features.! Incoming X-SSL-* headers are stripped before reaching the application on every site; setups behind an upstream proxy that sets these headers must capture the value in a server-http Nginx set directive (e.g. set $trusted_ssl_verify $http_x_ssl_client_verify) and re-inject it via REVERSE_PROXY_HEADERS — using proxy_set_header alone is insufficient because the header is already empty by the time it is evaluated.! When mTLS is enabled and the scheduler cache at /var/cache/bunkerweb is not persistent, mTLS remains disabled after a scheduler restart until the first job run completes and redistributes the CA bundle; a persistent cache volume is required for strict enforcement across restarts.
BunkerWeb adds TOTP TOTP A one-time password algorithm (RFC 6238) that generates short-lived codes from a shared secret and the current time, giving cyber tools phishing-resistant second-factor authentication without a server round-trip. -based 2FA 2FA Two-Factor Authentication, an authentication scheme requiring a second proof of identity beyond a password, so a stolen credential alone cannot grant access. for admin accounts with encrypted key storage and rotation support via TOTP_ENCRYPTION_KEYS.
└──▷ USE IT
Supply your own TOTP encryption key so 2FA enrollments survive container recreations even without a persistent volume.
docker-compose.yml
copy
# TOTP_ENCRYPTION_KEYS must be exactly 43 characters (e.g. output of passlib generate_secret())
TOTP_ENCRYPTION_KEYS: "aB3dEfGhIjKlMnOpQrStUvWxYz0123456789AbCdE"
Rotate TOTP encryption keys while keeping existing 2FA enrollments valid by supplying both the old and new key in a JSON map.
docker-compose.yml
copy
TOTP_ENCRYPTION_KEYS: '{"new": "aB3dEfGhIjKlMnOpQrStUvWxYz0123456789AbCdE", "old": "zY9xWvUtSrQpOnMlKjIhGfEdCbA9876543210ZyXw"}'
Adds TOTP-based two-factor authentication for admin and user accounts, with secrets stored encrypted in the database using keys persisted in /var/lib/bunkerweb/.totp_encryption_keys.json. Not checked yet Introduces the TOTP_ENCRYPTION_KEYS environment variable (space-separated keys or JSON map, each key exactly 43 characters) to supply or rotate TOTP encryption keys without relying on auto-generated ones. Not checked yet Supports TOTP encryption key rotation via a JSON map value in TOTP_ENCRYPTION_KEYS: old keys remain alongside the new one so existing 2FA enrollments stay valid. Not checked yet Persisting the /data volume in the BunkerWeb UI container preserves TOTP encryption keys, Biscuit keys, and the Flask secret across container recreations, making TOTP_ENCRYPTION_KEYS optional. Not checked yet At startup the UI resolves TOTP keys from the first available source: /var/lib/bunkerweb/.totp_encryption_keys.json, then TOTP_ENCRYPTION_KEYS; if neither is usable a new random set is generated and all existing 2FA enrollments are invalidated. Not checked yet
5 details in Everything
BunkerWeb 1.6.14 adds mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. CA bundle and CRL CRL A Certificate Revocation List is a signed file, published by a certificate authority, listing certificates it has revoked before expiry so that clients can reject compromised or mis-issued credentials without contacting the CA live. distribution via Scheduler, client-hint blocking controls, and hardened X-SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. -* header stripping.
└──▷ USE IT
Supply a mTLS client CA bundle and CRL entirely inline to the Scheduler so no volume mounts are needed on BunkerWeb instances.
env
copy
MTLS_CA_CERTIFICATE_DATA=<base64-or-pem-bundle>
MTLS_CRL_DATA=<base64-or-pem-crl>
Re-allow a specific client hint after the new default blocks all ch-* directives, so adaptive-image services continue to receive DPR information.
text
copy
# In your BunkerWeb service environment or UI, append to Permissions-Policy:
ch-dpr=(self)
Adds MTLS_CA_CERTIFICATE_DATA to supply the mTLS client CA bundle directly as base64 or PEM inline (e.g. via the web UI), without mounting files into BunkerWeb containers. Not checked yet Adds MTLS_CA_CERTIFICATE_PRIORITY to control the source priority of the client CA bundle (file path vs. inline data). Not checked yet Adds MTLS_CRL_DATA to supply a PEM-encoded certificate revocation list inline as base64 or PEM, enabling BunkerWeb to reject revoked client certificates. Not checked yet Adds MTLS_CRL_PRIORITY to control the source priority of the client CRL (file path vs. inline data). Not checked yet Scheduler now validates, caches under /var/cache/bunkerweb, and distributes CA bundles and CRLs to every BunkerWeb instance automatically on each job run — no per-instance file mounts required. Not checked yet
+3 more
show less
Strips all inbound X-SSL-* request headers on every site (HTTP/1.1, HTTP/2 HTTP/2 The second major version of the HTTP protocol, standardized by the IETF, adding multiplexed streams, header compression, and binary framing over a single TCP connection to cut latency and reduce overhead. , HTTP/3 HTTP/3 The third major version of HTTP, standardized by the IETF, which runs over QUIC instead of TCP, eliminating head-of-line blocking and reducing connection latency for faster, more resilient data transfer. ), whether mTLS is enabled or not, so downstream apps cannot receive spoofed client-certificate metadata. Not checked yet Permissions Policy default now blocks client-hint directives (ch-*); services that rely on Accept-CH (e.g. Sec-CH-Prefers-Color-Scheme ) can re-allow specific hints such as ch-dpr=(self) via the Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. configuration. Not checked yet Blocked-request reports use a circular buffer capped at a configurable limit per NGINX worker (without Redis) or a global cap (with Redis); reports are cleared on restart unless Redis persistence is enabled — exports to syslog or a SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. are recommended for long-term retention. Not checked yet
8 details in Everything
BunkerWeb 1.6.14 adds TOTP TOTP A one-time password algorithm (RFC 6238) that generates short-lived codes from a shared secret and the current time, giving cyber tools phishing-resistant second-factor authentication without a server round-trip. -based 2FA 2FA Two-Factor Authentication, an authentication scheme requiring a second proof of identity beyond a password, so a stolen credential alone cannot grant access. with encrypted secrets, Biscuit keys, and server-side sessions pinned to IP and User-Agent.
└──▷ USE IT
Persist TOTP encryption keys and Biscuit keys across container recreations by mounting a volume on /data in the UI service.
docker-compose.yml
copy
services:
bw-ui:
image: bunkerity/bunkerweb-ui:1.6.14
volumes:
- bw-ui-data:/data # persists Flask secret, TOTP encryption keys, and Biscuit keys
volumes:
bw-ui-data:
Adds TOTP-based two-factor authentication for admin accounts; secrets are stored encrypted in the database with keys kept in /var/lib/bunkerweb/.totp_encryption_keys.json. Not checked yet Introduces TOTP_ENCRYPTION_KEYS environment variable (space-separated keys or a JSON map, each key exactly 43 characters) to supply or rotate your own TOTP encryption keys instead of relying on auto-generated ones. Not checked yet Persists Flask secret, Biscuit keys, and TOTP encryption keys by mounting a volume on /data in the bunkerweb-ui container (symlinked to /data/lib), surviving container recreation. Not checked yet Implements server-side sessions pinned to client IP and User-Agent, with a default idle lifetime of 12 hours and a hard cap of 7 days. Not checked yet Session cookies can be made permanent (surviving browser restarts) without issuing a separate long-lived token; sessions remain bound by the idle and hard-cap limits and are revoked immediately on logout, password change, or Wipe other sessions . Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Recreating the bunkerweb-ui container without a persistent volume on /data wipes TOTP encryption keys; every user loses their 2FA enrollment and must re-enroll.! Setting TOTP_ENCRYPTION_KEYS to an invalid value (e.g. fewer than 43 characters, such as the placeholder changeme) causes the key to be discarded and replaced by a random one, leaving 2FA unusable until the variable is cleared manually — unlike leaving the variable unset, this also prevents the admin enrollment from being reset automatically.
BunkerWeb 1.6.14 adds mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. client certificate support with centralized CA/CRL CRL A Certificate Revocation List is a signed file, published by a certificate authority, listing certificates it has revoked before expiry so that clients can reject compromised or mis-issued credentials without contacting the CA live. distribution and Redis-backed metrics sync.
└──▷ USE IT
Enable mTLS by pointing the Scheduler at a CA bundle file and a CRL — no per-instance mounting needed.
env
copy
MTLS_CA_CERTIFICATE_PRIORITY=file
MTLS_CA_CERTIFICATE_DATA=
MTLS_CRL_PRIORITY=file
MTLS_CRL_DATA=
Supply the CA bundle and CRL inline (e.g. in a containerised deployment where file mounts are inconvenient).
env
copy
MTLS_CA_CERTIFICATE_PRIORITY=data
MTLS_CA_CERTIFICATE_DATA=<base64-or-PEM-bundle>
MTLS_CRL_PRIORITY=data
MTLS_CRL_DATA=<base64-or-PEM-crl>
Set Redis metrics TTL TTL Time to live, a limit on how long data remains valid or how far a packet can travel. Caches use a time limit; IP packets use a hop limit. to 30 days so inactive blocked-request data ages out automatically while active data stays live.
env
copy
METRICS_REDIS_TTL=2592000
Adds MTLS_CA_CERTIFICATE_PRIORITY config key to control the source of the client CA bundle (file path vs. inline data), with MTLS_CA_CERTIFICATE_DATA for supplying the trusted CA bundle directly as base64 or plaintext PEM (e.g. via the web UI). Not checked yet Adds MTLS_CRL_PRIORITY and MTLS_CRL_DATA config keys to supply a PEM-encoded certificate revocation list (CRL) either as a file path or inline base64/PEM data, enabling BunkerWeb to deny revoked client certificates. Not checked yet Scheduler validates, caches, and distributes CA bundles and CRLs to every BunkerWeb instance automatically — no per-instance file mounting required; updates are picked up on the next job run. Not checked yet Inbound X-SSL-* headers are stripped on all requests (HTTP/1.1, HTTP/2 HTTP/2 The second major version of the HTTP protocol, standardized by the IETF, adding multiplexed streams, header compression, and binary framing over a single TCP connection to cut latency and reduce overhead. , HTTP/3 HTTP/3 The third major version of HTTP, standardized by the IETF, which runs over QUIC instead of TCP, eliminating head-of-line blocking and reducing connection latency for faster, more resilient data transfer. ) across every site regardless of mTLS state, preventing clients from spoofing values such as X-SSL-Client-Verify: SUCCESS; only values derived from the verified TLS handshake are forwarded. Not checked yet Adds METRICS_REDIS_TTL config key (default 2592000 seconds) to control expiry of Redis metrics keys, with active keys refreshed each sync so abandoned data becomes evictable under memory pressure. Not checked yet
+2 more
show less
Metrics plugin now synchronizes blocked-request data to Redis, providing a centralized view of security events across multiple BunkerWeb instances; new reports are buffered per-worker and synced once Redis memory frees to avoid data loss. Not checked yet Extends Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. to also block client hints (ch-* directives); services relying on Accept-CH (e.g. Sec-CH-Prefers-Color-Scheme for dark-mode detection) must explicitly re-allow the needed ch-* features (e.g. ch-dpr=(self)). Not checked yet
7 details in Everything
BunkerWeb 1.6.14 adds per-service CrowdSec multisite settings, a certificate validator in the UI, and new metrics/policy controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.14 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.14
└──▷ TRY IT
Run the all-in-one container in an air-gapped environment where CrowdSec must not call home to the Central API.
copy
$ docker run -e DISABLE_ONLINE_API=true bunkerity/bunkerweb-all-in-one:1.6.14
Makes every CROWDSEC_* setting multisite, so individual services can point at different Local API or AppSec AppSec Application security: the practice of finding and fixing vulnerabilities in software during design, development, and testing. Cyber tools build on AppSec workflows to shift vulnerability detection earlier in the development lifecycle. endpoints; set CROWDSEC_API to an empty string on a service to retain AppSec inspection without the decision lookup. Not checked yet Adds METRICS_REDIS_TTL setting to control TTL TTL Time to live, a limit on how long data remains valid or how far a packet can travel. Caches use a time limit; IP packets use a hop limit. for metrics stored in Redis, alongside atomic list and facet updates and buffering during Redis OOM OOM An out-of-memory condition: a program requests more memory than the system or device can provide. The allocation fails or the operating system may stop the process. events. Not checked yet Adds DISABLE_ONLINE_API environment variable to the all-in-one image (matching the official CrowdSec image name) to run CrowdSec without registering to the Central API. Not checked yet Adds a Validate certificate button on the custom certificate settings page in the UI, checking a pasted or uploaded key pair for mismatches, encrypted keys, expiry, and missing server name coverage before the service is saved. Not checked yet Denies Chrome built-in AI APIs in the default PERMISSIONS_POLICY header value. Not checked yet
+2 more
show less
Allows the QUERY HTTP method by default in ALLOWED_METHODS and bundled service templates. Not checked yet Honors the k/m suffix on METRICS_MAX_BLOCKED_REQUESTS_REDIS when bounding report reads. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! KEEP_CONFIG_ON_RESTART is no longer listed as a configurable setting in the web UI or database — it must be set in the environment or in /etc/bunkerweb/variables.env on Linux, as it is read by the entrypoint before the database is reachable.! Existing remember me long-lived tokens are rejected and deleted on the next request; users relying on year-long browser persistence will be logged out and must re-authenticate. Extend SESSION_LIFETIME_HOURS and SESSION_ABSOLUTE_HOURS to replicate long-lived sessions.! Biscuit tokens carrying more than a single block are now rejected by the API; any client that appended extra blocks to its tokens will have its requests refused.
advisory CVE-2026-75514
Jul 16, 2026
·
issue 128
CVE-2026-75514: rDNS bypass via missing forward-confirmation (FCrDNS) in blacklist, greylist, whitelist and antibot (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 5.9, affects < 1.6.13)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
BunkerWeb v1.6.13 adds global rate limiting, per-URI country check bypass, and post-challenge redirect control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.13 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.13
└──▷ USE IT
Protect a backend from being overwhelmed by capping total inbound requests across all clients before per-IP limits are evaluated.
ini
copy
USE_LIMIT_REQ_GLOBAL=yes
LIMIT_REQ_GLOBAL_RATE=500r/s
Exempt health-check and metrics endpoints from country-based blocking so monitoring systems in blocked regions still reach them.
ini
copy
COUNTRY_IGNORE_URI=/health /metrics\?.*
Send users to a welcome page after passing an antibot challenge instead of replaying their original (potentially POST) request.
ini
copy
ANTIBOT_SUCCESS_URI=/welcome
Adds USE_LIMIT_REQ_GLOBAL and LIMIT_REQ_GLOBAL_RATE settings to cap the total aggregate request rate for a service across all clients and URLs, evaluated before per-IP and per-URL limits. Not checked yet Adds COUNTRY_IGNORE_URI to skip country whitelist and blacklist checks for URIs matching a list of PCRE PCRE A widely used open-source regular expression library, maintained by the PCRE project, that gives tools Perl-compatible pattern matching without depending on Perl itself. expressions, matched against both the request path and the full URI including query string. Not checked yet Adds ANTIBOT_SUCCESS_URI to redirect clients to a fixed URI after successfully completing a challenge, rather than returning them to the originally requested page. Not checked yet
3 details in Everything
advisory CVE-2026-54728
Jul 8, 2026
·
issue 128
CVE-2026-54728: Authenticated privilege escalation privilege escalation Gaining permissions beyond those an account or process initially had. It can turn limited access into administrator control or access to another user's resources. via Host header handling in BunkerWeb UI and API (affects < 1.6.12)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-61718
Jul 8, 2026
·
issue 128
CVE-2026-61718: Read-only Web UI users can delete job cache files due to missing authorization on /cache/ routes (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 5.4, affects >= 1.6.2, < 1.6.12)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
BunkerWeb v1.6.12 adds upstream TLS verification, per-path mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. , a full logs viewer overhaul, and tightened API token security.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.12 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.12
└──▷ USE IT
Enforce TLS verification when BunkerWeb proxies to an internal HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. backend, supplying a custom CA bundle.
ini
copy
REVERSE_PROXY_SSL_VERIFY=yes
REVERSE_PROXY_SSL_VERIFY_DEPTH=2
REVERSE_PROXY_SSL_TRUSTED_CERTIFICATE=/etc/bunkerweb/certs/internal-ca.pem
Require mTLS only on sensitive API paths while leaving public endpoints unaffected.
ini
copy
MTLS_URL_1=^/api/admin.*
Cap scheduler thread-pool workers to limit database connection pressure in high-traffic deployments.
ini
copy
SCHEDULER_MAX_WORKERS=4
Adds upstream HTTPS certificate verification for reverse proxy via REVERSE_PROXY_SSL_VERIFY, REVERSE_PROXY_SSL_VERIFY_DEPTH, REVERSE_PROXY_SSL_TRUSTED_CERTIFICATE, REVERSE_PROXY_SSL_TRUSTED_CERTIFICATE_DATA, and REVERSE_PROXY_SSL_TRUSTED_CERTIFICATE_PRIORITY settings. Not checked yet Adds MTLS_URL_n regex setting to enforce mTLS selectively per path rather than site-wide. Not checked yet Adds SCHEDULER_MAX_WORKERS to cap the job-executor thread pool and reduce database pool pressure under load. Not checked yet Extends ANTIBOT_IGNORE_URI to match full request URIs including query strings. Not checked yet Supports pre-hashed bcrypt bcrypt A deliberately slow password-hashing function, so a stolen password database takes far longer to crack by guessing. Argon2 and scrypt are newer alternatives built on the same idea. values for ADMIN_PASSWORD, enabling secret-manager and GitOps GitOps A practice where Git repositories serve as the single source of truth for infrastructure and application state, with automated systems continuously reconciling live environments to match what is declared in version control. workflows. Not checked yet
+7 more
show less
Hardens Biscuit API token generation by binding Host header, client IP, and username as typed terms; adds optional API_ALLOWED_HOSTS allowlist. Not checked yet Adds API_ACL_BOOTSTRAP_FILE bcrypt hash validation, rejecting weak or malformed values on startup. Not checked yet Overhauls the UI logs viewer with syntax highlighting, severity filters with counts, in-page search, live-tail with pause, download/copy actions, local-time display, and collapsible multi-line entries. Not checked yet Adds fold support for multi-line file settings (e.g., PEM certificates and keys) in the RAW config editor. Not checked yet Improves BunkerNet UI status reporting with Connected / API unreachable / Not registered states, masked instance ID, and disk self-heal. Not checked yet Adds Ubuntu 26.04 Resolute Raccoon as a supported Linux package target. Not checked yet Updates ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. to 3.0.16 and Core Rule Set to 4.27.0. Not checked yet
12 details in Everything
BunkerWeb 1.6.10 adds per-backend HTTP version control, cross-subdomain session sharing, modern TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. installer, and new UI bulk-action controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.10 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.10
└──▷ USE IT
Route a specific backend over HTTP/2 HTTP/2 The second major version of the HTTP protocol, standardized by the IETF, adding multiplexed streams, header compression, and binary framing over a single TCP connection to cut latency and reduce overhead. while keeping other upstreams on HTTP/1.1 — useful for gRPC gRPC An open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. or h2-capable origin servers.
yaml
copy
REVERSE_PROXY_URL=/api
REVERSE_PROXY_HOST=https://backend-h2.internal
REVERSE_PROXY_HTTP_VERSION=2
Share antibot challenge state across subdomains so users aren't re-challenged when moving between app.example.com and api.example.com.
yaml
copy
SESSIONS_DOMAIN=.example.com
Run the installer with the modern TUI prompts and pre-specify the server IP to skip the interactive IP selection menu.
copy
$ sudo ./install.sh --tui --server-ip 203.0.113.42
Adds MAX_HEADERS setting (default 100) to cap the number of request header lines accepted. Not checked yet Adds per-backend REVERSE_PROXY_HTTP_VERSION supporting 1.0, 1.1, and 2, overriding the global default per upstream. Not checked yet Adds SESSIONS_DOMAIN multisite setting to share antibot/challenge session state across sibling subdomains. Not checked yet Adds Web UI session lifecycle controls: SESSION_LIFETIME_HOURS (sliding idle TTL TTL Time to live, a limit on how long data remains valid or how far a packet can travel. Caches use a time limit; IP packets use a hop limit. ), SESSION_ABSOLUTE_HOURS (hard cap), and SESSION_ROLLING_HOURS (periodic session ID regeneration). Not checked yet Adds LETS_ENCRYPT_MAX_LOG_BACKUPS (default 50) to cap certbot log rotation. Not checked yet
+10 more
show less
Adds modern inline TUI installer prompts via gum, with fallback to whiptail then plain read; controlled by --tui, --no-tui, and BW_INSTALL_TUI. Not checked yet Adds --server-ip <IP> flag and SERVER_IP_INPUT to the installer; interactive installs present a menu when multiple IPv4s are detected. Not checked yet Supports k/m shorthand suffixes for metrics and datastore size settings, plus g/G for shared memory size settings. Not checked yet Allows custom uppercase HTTP methods containing underscores and dashes in ALLOWED_METHODS. Not checked yet Updates default Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. header to include local-network, local-network-access, and loopback-network directives. Not checked yet Adds 18 missing single-column database indexes, improving query performance for large deployments. Not checked yet Adds opt-in Select all N matching banner in UI list pages for bulk actions across pages. Not checked yet Adds import/export for custom configurations in the UI, including optional .zip bundles attached to service exports. Not checked yet CSV/Excel exports on Reports and Bans pages now include every column and honor active search and SearchPanes filters. Not checked yet Bundled ui and api templates now enable REVERSE_PROXY_KEEPALIVE=yes by default. Not checked yet
15 details in Everything
BunkerWeb v1.6.9 adds a gRPC gRPC An open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. proxy plugin, ZeroSSL CA support, three new DNS providers, country group filtering, and new NGINX timeout controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.9 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.9
└──▷ USE IT
Tune database connection pooling for high-traffic deployments to improve scheduler resilience under load.
yaml
copy
DATABASE_POOL_SIZE=20
DATABASE_POOL_MAX_OVERFLOW=10
DATABASE_POOL_TIMEOUT=30
DATABASE_POOL_RECYCLE=1800
DATABASE_POOL_PRE_PING=yes
DATABASE_REQUEST_RETRY_ATTEMPTS=5
DATABASE_REQUEST_RETRY_DELAY=2
New gRPC plugin enables proxying of gRPC traffic to upstream services with TLS, SNI SNI A TLS extension that lets a client declare which hostname it is connecting to during the handshake, allowing one server to host multiple certificates on a single IP address. , custom headers, and retry policy support. Not checked yet Let's Encrypt plugin now supports selecting between Let's Encrypt and ZeroSSL as the certificate authority, including ZeroSSL-specific settings. Not checked yet Adds Gandi, Hetzner, and ClouDNS as DNS providers in the Let's Encrypt plugin. Not checked yet Country plugin gains the ability to whitelist or blacklist groups of countries, not just individual countries. Not checked yet New CLIENT_BODY_TIMEOUT, CLIENT_HEADER_TIMEOUT, KEEPALIVE_TIMEOUT, and SEND_TIMEOUT settings expose NGINX timeout controls for long-lived connections. Not checked yet
+15 more
show less
New file setting type lets users upload files directly from the Web UI and use their content as setting values. Not checked yet Adds MAX_REQUESTS setting (with UI_MAX_REQUESTS / API_MAX_REQUESTS overrides) to configure Gunicorn worker max requests before restart. Not checked yet Adds MAX_CONTENT_LENGTH setting to the Web UI to configure the maximum upload size (defaults to 50 MB). Not checked yet Sensitive field values in the Let's Encrypt plugin are now redacted from logs and process arguments (except at TRACE level). Not checked yet HTTP/HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. /STREAM/TLS ports can now be left empty to disable listening on those ports. Not checked yet Global settings UI gains an override non-global services functionality. Not checked yet Web UI now supports editing settings via the wizard method. Not checked yet Adds DATABASE_POOL_SIZE, DATABASE_POOL_MAX_OVERFLOW, DATABASE_POOL_TIMEOUT, DATABASE_POOL_RECYCLE, DATABASE_POOL_PRE_PING, DATABASE_POOL_RESET_ON_RETURN, DATABASE_RETRY_TIMEOUT, DATABASE_REQUEST_RETRY_ATTEMPTS, and DATABASE_REQUEST_RETRY_DELAY settings for fine-grained database connection pool tuning. Not checked yet Autoconf adds experimental support for GRPCRoute in the Kubernetes Gateway API integration. Not checked yet CUSTOM_SSL_CERT_DATA and CUSTOM_SSL_KEY_DATA settings are now of type file, allowing direct certificate and key upload from the Web UI. Not checked yet Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. header default value updated to include the gamepad feature. Not checked yet Home dashboard enhanced with new IP blocking metrics and improved tooltips. Not checked yet Reports page gains improved filter handling and data fetching. Not checked yet CrowdSec updated to version 1.7.6 in the all-in-one image. Not checked yet NGINX updated to v1.28.2 for Fedora 42 and 43. Not checked yet
20 details in Everything
BunkerWeb v1.6.8 adds concurrent Let's Encrypt cert generation, three new DNS providers, Gateway API support, and services import with drag-and-drop.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.8 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.8
└──▷ USE IT
Enable concurrent Let's Encrypt certificate generation across all services to cut provisioning time on multi-site deployments.
yaml
copy
LETS_ENCRYPT_CONCURRENT_REQUESTS=yes
Preserve the running nginx config across scheduler restarts to avoid a temporary-config gap during maintenance windows.
yaml
copy
KEEP_CONFIG_ON_RESTART=yes
Disable request body buffering on a reverse-proxy service to stream large uploads directly to the upstream without holding them in memory.
yaml
copy
REVERSE_PROXY_REQUEST_BUFFERING=off
New REVERSE_PROXY_REQUEST_BUFFERING setting in the Reverse Proxy plugin lets operators control whether request bodies are buffered before proxying (default: on). Not checked yet New LETS_ENCRYPT_CONCURRENT_REQUESTS setting enables parallel certificate generation across multiple services, speeding up multi-site Let's Encrypt provisioning (default: no). Not checked yet Adds GoDaddy, TransIP, and Domeneshop as DNS challenge providers in the Let's Encrypt plugin. Not checked yet New global KEEP_CONFIG_ON_RESTART setting preserves the existing nginx configuration across restarts instead of regenerating a temporary one each time (default: no). Not checked yet Templator engine refactored to use Jinja2, unlocking richer templating capabilities for custom configurations. Not checked yet
+9 more
show less
Experimental Kubernetes Gateway API controller support added (Gateway/HTTPRoute resources) for Autoconf deployments. Not checked yet API now supports HTTP/2 HTTP/2 The second major version of the HTTP protocol, standardized by the IETF, adding multiplexed streams, header compression, and binary framing over a single TCP connection to cut latency and reduce overhead. in Gunicorn for improved performance and protocol compatibility. Not checked yet CIDR CIDR A notation for a block of IP addresses, such as 10.0.0.0/24. The number after the slash says how many leading address bits identify the network. annotation support added for FORWARDED_ALLOW_IPS and PROXY_ALLOW_IPS settings; defaults updated to cover common private network ranges. Not checked yet Web UI services table now displays security mode per service at a glance. Not checked yet Web UI gains services import functionality with drag-and-drop support. Not checked yet Redis report querying in the UI enhanced with filter parsing and chunked retrieval for large datasets. Not checked yet Easy Install script gains an option to automatically install a Redis server for data persistence and caching. Not checked yet DuggyTuxy Data-Shield IPv4 Blocklist added to the built-in blacklist sources. Not checked yet NGINX updated to v1.28.2 and Core Rule Set updated to v4.23.0 (CRSv3 to v3.3.8). Not checked yet
14 details in Everything
BunkerWeb v1.6.7 adds post-quantum post-quantum Cryptography designed to stay secure against a large quantum computer, which could break today's RSA and elliptic-curve keys. NIST standardized the first algorithms in 2024 as ML-KEM, ML-DSA and SLH-DSA. TLS prep, syslog support, draft configs, HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. UI, and granular plugin ordering.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.7 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.7
└──▷ USE IT
Enable syslog output alongside existing log handlers so a SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. can ingest BunkerWeb events in real time.
yaml
copy
ACCESS_LOG=syslog:server=192.168.1.10:514
ERROR_LOG=syslog:server=192.168.1.10:514
Control SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. session cache size to tune TLS performance for high-traffic deployments.
yaml
copy
SSL_SESSION_CACHE_SIZE=20m
Create a draft custom configuration in the UI so changes are reviewed before going live.
📍 In the web UI, go to Custom Configurations, create or edit a configuration, and save it as Draft. Toggle it to Online only when ready to publish.
Adds dynamic ECDH curve resolution for SSL/TLS negotiation, enabling post-quantum cryptography post-quantum cryptography Cryptography designed to stay secure against a large quantum computer, which could break today's RSA and elliptic-curve keys. NIST standardized the first algorithms in 2024 as ML-KEM, ML-DSA and SLH-DSA. readiness (X25519MLKEM768) with OpenSSL 3.5+. Not checked yet Optimizes Redis connection handling by reusing pooled connections in Lua timers for reduced overhead. Not checked yet Enables sending logs to a syslog server with support for multiple log handlers simultaneously. Not checked yet New LETS_ENCRYPT_DNS_CREDENTIAL_DECODE_BASE64 setting controls whether Base64 decoding is applied to DNS credentials in the Let's Encrypt plugin. Not checked yet New ACCESS_LOG and ERROR_LOG settings allow configuring access and error log destinations per BunkerWeb instance. Not checked yet
+15 more
show less
Upgrades Auth Basic plugin: credentials are now hashed with salted scrypt scrypt A password-hashing function that requires substantial memory for each guess, making large-scale password cracking more expensive. (CSPRNG CSPRNG A cryptographically secure pseudorandom number generator — an algorithm that produces unpredictable output suitable for secrets like keys and tokens, where a standard PRNG's statistical randomness alone would be exploitable. ) and verified in constant time. Not checked yet Updates Bad Behavior plugin to apply default-server bans globally across all services automatically. Not checked yet Adds draft mode for custom configurations — changes are not applied until explicitly published, with draft/online toggle in the web UI. Not checked yet New SSL_SESSION_CACHE_SIZE setting configures SSL session cache size (e.g., 10m, 512k, or off/none to disable). Not checked yet Enhances Antibot plugin to redirect users back to the original request path after a successful challenge using the Referer header. Not checked yet Allows manual editing of custom configurations created via the web UI or API. Not checked yet New PLUGINS_ORDER_* settings allow customizing plugin execution order per phase, with multisite support. Not checked yet Adds HTTPS support directly to the web UI via certificate and key configuration, eliminating the need for a reverse proxy. Not checked yet Enhances UI session management with Redis backend support and configurable session lifetime. Not checked yet Refactors API rate limiting to be configurable via settings. Not checked yet Updates CrowdSec integration to version 1.7.4 in the all-in-one image. Not checked yet Adds Linux package support for Fedora 43. Not checked yet Updates NGINX to v1.28.1 across all integrations. Not checked yet Updates Core Rule Set to v4.21.0. Not checked yet New KUBERNETES_REVERSE_PROXY_SUFFIX_START setting makes Ingress controller reverse proxy indexing configurable (default 1). Not checked yet
20 details in Everything
└──▷ BREAKING ON UPGRADE
! Fedora 41 is no longer supported; upgrade to Fedora 42 or 43 before deploying v1.6.7 Linux packages.
BunkerWeb v1.6.6 adds mutual TLS mutual TLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. plugin, DuckDNS/PowerDNS Let's Encrypt providers, country-based antibot controls, and a new API service template.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.6 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.6
└──▷ USE IT
Restrict antibot challenges to visitors from specific high-risk countries while letting known-safe countries through without a challenge.
yaml
copy
ANTIBOT_ONLY_COUNTRY=CN RU
ANTIBOT_IGNORE_COUNTRY=US GB DE
Harden Auth Basic by increasing bcrypt bcrypt A deliberately slow password-hashing function, so a stolen password database takes far longer to crack by guessing. Argon2 and scrypt are newer alternatives built on the same idea. rounds beyond the default for sensitive admin endpoints.
yaml
copy
USE_AUTH_BASIC=yes
AUTH_BASIC_ROUNDS=800000
New mtls plugin adds mutual TLS client certificate authentication with configurable verification modes, chain depth control, and optional header forwarding for downstream authorization. Not checked yet Adds ANTIBOT_IGNORE_COUNTRY and ANTIBOT_ONLY_COUNTRY settings to the Antibot plugin for country-based challenge bypassing or enforcement. Not checked yet Adds AUTH_BASIC_ROUNDS setting to the authbasic plugin to tune bcrypt password hashing strength (default: 656000, range: 1000–999999999). Not checked yet Switches Auth Basic password hashing to bcrypt for improved security. Not checked yet Adds a new API template to quickly protect an API service using BunkerWeb. Not checked yet
+17 more
show less
Starts monitoring HTTP 405 and 400 status codes, surfacing them on the reports page. Not checked yet IP whitelisting checks added to the badbehavior module to prevent banning whitelisted IPs; whitelisted IPs are served the default page even when the default server is deactivated. Not checked yet Let's Encrypt mail handling now validates the configured email, warns if missing or invalid, and automatically adds --register-unsafely-without-email to Certbot when no valid email is present. Not checked yet Adds METRICS_MEMORY_MAX_RETRIES setting to retry metric operations on memory failure. Not checked yet Enables editing of API settings in the web UI and UI settings via the API. Not checked yet UI gains a RAW mode for editing and creating templates, with disabled-settings highlighting and Ctrl+S / Command+S save shortcuts. Not checked yet Reports page export now uses server-side chunked processing for improved performance on large datasets. Not checked yet Adds DB-IP attribution to the web UI reports page footer. Not checked yet DataTable state saving is now automatically enabled across the UI. Not checked yet Autoconf adds event debouncing in Docker, Ingress, and Swarm controllers for improved configuration management. Not checked yet Kubernetes integration gains an annotation to ignore specific services in Autoconf. Not checked yet Kubernetes ConfigMaps of type settings can now be applied to services more easily. Not checked yet Updates MODSECURITY_REQ_BODY_NO_FILES_LIMIT regex to support human-readable size values. Not checked yet Updates the default Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. header to include private-state-token-issuance and private-state-token-redemption. Not checked yet Linux Easy Install script enhanced with manager and worker mode configurations. Not checked yet Adds RHEL RHEL Red Hat Enterprise Linux, a commercially supported Linux distribution maintained by Red Hat, chosen by cyber tools for its long support lifecycle, certified hardware compatibility, and enterprise deployment prevalence. 9.7 and RHEL 10.1 package support. Not checked yet Per-plugin commit option added to the plugin update process with improved error handling. Not checked yet
22 details in Everything
BunkerWeb 1.6.6-rc2 adds mtls plugin, DuckDNS provider, API template, and ANTIBOT country filters
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.6-rc2 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.6-rc2
AUTH_BASIC_ROUNDS config key added to the authbasic plugin to set password hashing strength (default: 656000, range: 1000-999999999) Not checked yet ANTIBOT_IGNORE_COUNTRY and ANTIBOT_ONLY_COUNTRY settings added to the Antibot plugin for country-based challenge prompting/bypassing Not checked yet New mtls plugin introduced for mutual TLS mutual TLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. client certificate authentication with configurable verification modes and chain depth control Not checked yet New letsencrypt plugin now supports DuckDNS as a DNS provider Not checked yet
4 details in Everything
Adds per-plugin commit options, API/UI settings bidirectional edit, and RAW mode template editing shortcuts.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.6-rc1 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.6-rc1
Adds METRICS_MEMORY_MAX_RETRIES to control retry operations for metrics linked to memory failures Not checked yet Enables edition of API settings directly in the web UI and UI settings via the API Not checked yet Adds RAW mode for editing/creating templates with Ctrl+S / Command+S save shortcuts Not checked yet
3 details in Everything
BunkerWeb v1.6.5 adds a REST control-plane API, HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. for internal API, token auth, reCAPTCHA v3 support, and a new Templates management UI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.5 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.5
└──▷ USE IT
Limit how long idle UI user sessions persist in the database, reducing stale-session exposure.
yaml
copy
DATABASE_MAX_SESSION_AGE_DAYS=7
Create and apply a reusable service template from the new Templates management page so new services inherit a consistent baseline configuration.
📍 In the UI, go to Templates › New Template, define your settings, save, then when creating or editing a service select the template from the Template column in the Services page.
Introduces a dedicated control-plane service exposing a REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. to programmatically list/register instances, trigger reload/stop, and manage bans, plugins, jobs, and configurations. Not checked yet Adds HTTPS support for BunkerWeb's internal API. Not checked yet Adds optional API token authentication for BunkerWeb API calls to enable token-based access control. Not checked yet Adds reason data for bad behavior bans and reports. Not checked yet Adds session retention configuration via the DATABASE_MAX_SESSION_AGE_DAYS setting in the Database plugin, with an automatic cleanup job to purge old UI user sessions. Not checked yet
+10 more
show less
Adds support for the new reCAPTCHA version in the Antibot plugin. Not checked yet Adds the ability to ignore IPs in the DNSBLDNSBL A DNS-based blocklist: a published list of IP addresses or domains associated with spam or abuse, queried via standard DNS lookups so cyber tools can check reputation in real time without downloading the full list. plugin. Not checked yet Introduces a Templates management page in the UI to create, edit, clone, and delete service templates. Not checked yet Adds a new Template column in the services page showing which template a service is based on, with filtering support. Not checked yet Adds the ability to quickly ban IP addresses directly from the reports page. Not checked yet Introduces a reloading health status for BunkerWeb when NGINX is reloading. Not checked yet Updates the default Permissions-Policy Permissions-Policy An HTTP response header that lets a server declare which browser features—camera, geolocation, microphone—are allowed or blocked for a page and its iframes, replacing the older Feature-Policy header. header value to include additional features and remove deprecated ones. Not checked yet Updates CoreRuleSet to v4.19.0. Not checked yet All-in-One image updates CrowdSec to v1.7.0 and adds support for disabling specific CrowdSec parsers. Not checked yet Adds upgrade capability to the easy-install script for seamless in-place Linux package updates. Not checked yet
15 details in Everything
BunkerWeb 1.6.5-rc3 adds API token auth, DNSBL DNSBL A DNS-based blocklist: a published list of IP addresses or domains associated with spam or abuse, queried via standard DNS lookups so cyber tools can check reputation in real time without downloading the full list. IP ignores, UI ban and health status features.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.5-rc3 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.5-rc3
Adds optional API token authentication via BUNKERWEB_API_TOKEN env var to control access to BunkerWeb API calls Not checked yet Adds IGNORE_IPS configuration option in the DNSBL plugin to exclude specific IPs from DNS blacklisting checks Not checked yet Enables quick banning of IP addresses directly from the reports page in the UI Not checked yet Introduces a new reloading health status for BunkerWeb and NGINX during restart cycles Not checked yet
4 details in Everything
Adds CrowdSec parser disabling, reCAPTCHA support in Antibot plugin
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.5-rc2 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.5-rc2
Add parsers configuration key to disable specific CrowdSec parsers Not checked yet Add new reCAPTCHA version support in the Antibot plugin Not checked yet
2 details in Everything
v1.6.5-rc1 adds in-place upgrade support via easy-install script and UI promo/update controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.5-rc1 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.5-rc1
└──▷ TRY IT
Upgrade BunkerWeb in-place using the provided script.
copy
$ ./easy-install.sh upgrade
Force download PRO plugins directly from the UI without update checks.
📍 Click Force update on the PRO page in the web console.
Adds upgrade capability to the easy-install script for seamless in-place updates Not checked yet Add Force update button on PRO page to force the download of PRO plugins without checking for updates Not checked yet Enhance update-check job to utilize cached GitHub release data and improve error handling Not checked yet
3 details in Everything
BunkerWeb 1.6.4 adds human-readable size values for ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. request body limits and expands Linux platform support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.4 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.4
Enhances the ModSecurity plugin to accept human-readable size values (e.g., 10m, 512k) for request body limits on requests without files. Not checked yet Adds Linux package support for RHEL RHEL Red Hat Enterprise Linux, a commercially supported Linux distribution maintained by Red Hat, chosen by cyber tools for its long support lifecycle, certified hardware compatibility, and enterprise deployment prevalence. 10.0. Not checked yet Adds Linux package support for Debian 13 (Trixie). Not checked yet
3 details in Everything
BunkerWeb 1.6.3 adds multi-path Redirects, configurable antibot alphabet and split installation types
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.3 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.3
└──▷ TRY IT
Restrict antibot CAPTCHA characters to hexadecimal digits only.
copy
$ ANTIBOT_CAPTCHA_ALPHABET=0123456789ABCDEF
Redirect plugin now supports multiple source/destination paths for routing Not checked yet ANTIBOT_CAPTCHA_ALPHABET environment variable allows custom character sets for CAPTCHAs Not checked yet
2 details in Everything
BunkerWeb 1.6.3-rc3 adds custom robots.txt headers/footers and new DNS providers for Let's Encrypt
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.3-rc3 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.3-rc3
ROBOTSTXT_HEADER and ROBOTSTXT_FOOTER settings added to customize the robots.txt file content (Base64 encoded) Not checked yet domainoffensive.de added as a supported DNS provider in the letsencrypt plugin Not checked yet Dynu added as a supported DNS provider in the letsencrypt plugin Not checked yet
3 details in Everything
BunkerWeb 1.6.3-rc2 adds PRO setup wizard steps, Linux CrowdSec auto-install, and TOTP TOTP A one-time password algorithm (RFC 6238) that generates short-lived codes from a shared secret and the current time, giving cyber tools phishing-resistant second-factor authentication without a server round-trip. env var alias
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.3-rc2 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.3-rc2
└──▷ TRY IT
Use the new env var alias when configuring BunkerWeb via environment variables.
copy
$ export TOTP_ENCRYPTION_KEYS='my_secret_key_here'
Add Advanced settings section to the setup wizard to configure SERVER_NAME and the Let's Encrypt plugin Not checked yet Add TOTP_ENCRYPTION_KEYS as an alias for the TOTP_SECRETS environment variable Not checked yet Add CrowdSec automatic installation/configuration in the easy-install script for Linux distributions Not checked yet
3 details in Everything
Adds BunnyNet DNS provider support and new robotstxt plugin for automated robots.txt management.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.3-rc1 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.3-rc1
Add BunnyNet as a DNS provider in the letsencrypt plugin Not checked yet Add new robotstxt plugin to manage the robots.txt file from settings and serve it Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Dropped support for Fedora 40 in this release.
BunkerWeb v1.6.2 adds Redis-backed metrics, custom Let's Encrypt profiles, a UI healthcheck endpoint, and smarter download caching.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.2 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.2
└──▷ USE IT
Enable the web UI healthcheck endpoint so your orchestrator (e.g., Docker, Kubernetes) can probe BunkerWeb's UI liveness.
yaml
copy
ENABLE_HEALTHCHECK=yes
Implements Redis-backed metrics storage with optimized retrieval workflows for faster, more reliable performance. Not checked yet Adds support for custom Let's Encrypt profiles and logs profile changes during renewal. Not checked yet Adds an optional /healthcheck endpoint to the web UI for health monitoring, enabled via the ENABLE_HEALTHCHECK setting. Not checked yet Refactors download scripts to canonicalize and deduplicate URLs before fetching, with smarter cache management. Not checked yet Enhances logging to differentiate between allowed and denied access based on whitelist status. Not checked yet
+5 more
show less
Updates CrowdSec (All-in-One) to v1.6.9. Not checked yet Updates CoreRuleSet to v4.16.0. Not checked yet Adds Go Back button functionality on the unauthorized page. Not checked yet Improves dynamic translation handling and updates chart rendering on theme and language changes. Not checked yet Documents Valkey support alongside Redis for data persistence and caching. Not checked yet
10 details in Everything
BunkerWeb 1.6.2-rc7 adds number and multivalue setting types for UI inputs
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.2-rc7 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.2-rc7
Adds the number setting type to allow numeric validation in the web UI settings form Not checked yet
1 detail in Everything
Adds LETS_ENCRYPT_PASSTHROUGH setting to Let's Encrypt plugin for upstream passthrough
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.2-rc5 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.2-rc5
BunkerWeb 1.6.2-rc4 adds multiselect setting type, community blacklist plugin, and header hiding for reverse proxy
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.2-rc4 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.2-rc4
BLACKLIST_COMMUNITY_LISTS setting added to blacklist plugin for selecting community blocklists Not checked yet REVERSE_PROXY_HIDE_HEADERS setting added to Reverse Proxy plugin to hide upstream HTTP headers Not checked yet multiselect setting type introduced for choosing multiple options from a configurable list in plugins Not checked yet
3 details in Everything
v1.6.2-rc3 adds LETS_ENCRYPT_MAX_RETRIES config, Docker secrets support, and CrowdSec/Redis integration in all-in-one image.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.2-rc3 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.2-rc3
Add LETS_ENCRYPT_MAX_RETRIES setting to the Let's Encrypt plugin to configure certificate retry count Not checked yet Add clear notifications feature to both UI and backend for improved notification management Not checked yet Improve plugin navigation by displaying plugins as a vertical list on the left side of the card Not checked yet Display a small enabled/disabled icon next to each plugin name in the plugin sidebar Not checked yet Update QR code generation to use PilImage and output JPEG format Not checked yet
+7 more
show less
Add a modal to update ban durations, with support for localization Not checked yet Add system memory usage monitoring to the home page dashboard Not checked yet Refactor the data display on the report page for a more user-friendly experience Not checked yet Add quick actions for bans back Not checked yet Enhance reset button visibility and tooltip handling across various settings templates Not checked yet Add the possibility to delete cache files Not checked yet Provide an interactive installer script for BunkerWeb that guides users through setup options Not checked yet
12 details in Everything
BunkerWeb 1.6.2-rc2 adds LE profile options, IONOS DNS support, plaintext cert data, underscore header control, manual cert deletion, and UI multi-language.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.2-rc2 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.2-rc2
Adds LETS_ENCRYPT_PROFILE setting to choose certificate generation profiles (classic, tlsserver, shortlived) in the Let's Encrypt plugin Not checked yet Adds CUSTOM_SSL_CERT_DATA and CUSTOM_SSL_KEY_DATA settings to accept plaintext or base64-encoded custom certificate data in the customcert plugin Not checked yet Adds IONOS as a supported DNS provider in the letsencrypt plugin Not checked yet Adds REVERSE_PROXY_UNDERSCORES_IN_HEADERS setting (default no) to control underscore handling in the Reverse Proxy plugin Not checked yet Adds LETS_ENCRYPT_CUSTOM_PROFILE setting to allow a custom profile for the Let's Encrypt plugin Not checked yet
+4 more
show less
Adds LETS_ENCRYPT_DISABLE_PUBLIC_SUFFIXES setting (default yes) to disable public suffix checks in the Let's Encrypt plugin Not checked yet Adds permanent ban feature to the badbehavior plugin, web UI, and bwcli Not checked yet Adds manual deletion of Let's Encrypt certificates via the web UI Not checked yet Introduces multi-language support (ar, bn, en, es, fr, hi, pt, ru, ur, zh, de, it) in the web UI Not checked yet
9 details in Everything
v1.6.2-rc1 adds configurable SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. cipher levels, Antibot filter options, and Infomaniak DNS provider to letsencrypt plugin.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.2-rc1 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.2-rc1
Adds modern, intermediate, and old cipher level options to the SSL plugin configuration for granular control over TLS settings Not checked yet Adds custom cipher list support in the SSL plugin configuration via a new field (implied by ability to set) Not checked yet Adds configuration options in the Antibot plugin to ignore specific request attributes: URI, IP, reverse DNS, ASNASN Autonomous System Number — a globally unique identifier assigned by regional internet registries to a network operator, letting routing protocols distinguish which organization controls a block of IP addresses. , and User-Agent Not checked yet Allows configuration of the algorithm used for generating self-signed certificates in the Self-signed certificate plugin (default: ec-prime256v1) Not checked yet Adds Infomaniak as a supported DNS provider option within the letsencrypt plugin Not checked yet
5 details in Everything
BunkerWeb v1.6.1 ships an all-in-one Docker image and promotes CrowdSec to a built-in core plugin.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.1 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.1
New all-in-one Docker image bundles BunkerWeb, Scheduler, Autoconf, and UI into a single container for simplified deployments. Not checked yet Adds CrowdSec as a core plugin, bringing crowd-sourced threat intelligence natively into BunkerWeb without a separate integration. Not checked yet Enhances Let's Encrypt DNS credential handling to accept base64-encoded values and properly process escape sequences. Not checked yet Improves ban handling in the UI with stronger validation and informative responses scoped to ban scope and service. Not checked yet Adds failover message reporting in the UI for better visibility into service continuity events. Not checked yet
5 details in Everything
v1.6.1-rc2 adds PROXY_BUFFER_SIZE and PROXY_BUFFERS settings, custom plugin hooks/blueprints, and UI indicators for cloned service settings
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.1-rc2 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.1-rc2
Adds PROXY_BUFFER_SIZE and PROXY_BUFFERS environment variables to control proxy buffer configuration in multisite mode. Not checked yet Enables developers to create custom plugins using hooks and blueprints instead of relying solely on the plugin page. Not checked yet Displays a visual label in the UI to indicate which service settings have been cloned from the original. Not checked yet
3 details in Everything
v1.6.1-rc1 adds deSEC DNS provider support and several web UI enhancements.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.1-rc1 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.1-rc1
└──▷ HOW TO FIND IT
Navigate the UI to edit a previously auto-configured service.
📍 Go to instances › [Instance Name] › Services , select the autoconf service, and click Edit.
Adds deSEC DNS provider support in letsencrypt plugin Not checked yet Makes services created with the autoconf method editable in the web UI Not checked yet Adds an instance hostname validation in the instances page when adding a new instance Not checked yet
3 details in Everything
BunkerWeb 1.6.0 adds mCaptcha antibot mode and a new ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. global CRS setting to speed up multi-service config generation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.6.0 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.6.0
└──▷ USE IT
When you run many services and ModSecurity config generation is slow, enable the global CRS to share one ruleset across all services.
yaml
copy
USE_MODSECURITY_GLOBAL_CRS: "yes"
Adds mCaptcha as a new antibot mode for bot protection. Not checked yet New USE_MODSECURITY_GLOBAL_CRS setting lets you share a single CRS across all services instead of per-service CRS, accelerating configuration generation at scale. Not checked yet
2 details in Everything
BunkerWeb v1.6.0-rc3 adds bulk reporting in BunkerNet, Kubernetes ConfigMap overrides via annotation, a new anonymized support page, and Fedora 41 support.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.0-rc3 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.0-rc3
Adds bunkerweb.io/CONFIG_TYPE=settings annotation to Kubernetes ConfigMaps for easy setting overrides Not checked yet Introduces an anonymized Support page in the UI for quick log and configuration sharing Not checked yet Updates BunkerNet logic to send reports in bulk instead of one by one Not checked yet Adds Fedora 41 as a supported platform Not checked yet
4 details in Everything
BunkerWeb 1.6.0-rc2 adds SSLSSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. plugin, bwcli plugin_list, and stream support for Kubernetes integration
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.0-rc2 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.0-rc2
└──▷ TRY IT
List all installed plugins and their available subcommands via the CLI.
Introduces the ssl plugin to manage SSL/TLS settings independently of the misc plugin Not checked yet Adds the plugin_list command to the bwcli utility for listing available plugins and their commands Not checked yet Enables stream support within the Kubernetes integration Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The MODSECURITY_CRS_PLUGIN_URLS setting is renamed to MODSECURITY_CRS_PLUGINS
BunkerWeb 1.6.0-rc1 adds multi-user Auth basic, TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. toggle, country tracking bans, and new session/config flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.0-rc1 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.0-rc1
CHECK_PRIVATE_IP config key added to manage session IP address changes for private networks Not checked yet ALWAYS_REMEMBER functionality implemented for session persistence in login UI Not checked yet New temporary UI service displays startup errors if any occur while web UI is starting up Not checked yet Health check endpoint added and integrated into the scheduler for instance status monitoring Not checked yet Country tracking added to bans data Not checked yet
+4 more
show less
MODSECURITY_REQ_BODY_NO_FILES_LIMIT setting allows configuring SecRequestBodyNoFilesLimit in ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. Not checked yet Multi-user support added to Auth basic plugin Not checked yet TCP toggle listening supported in server-stream configuration, ensuring UDP UDP A network protocol that sends individual messages without guaranteeing delivery or order. Applications trade built-in reliability for less overhead and can add their own recovery. does not replace TCP when activated Not checked yet LISTEN_STREAM_PORT and LISTEN_STREAM_PORT_SSL settings now accept multiples to allow listening on multiple ports Not checked yet
9 details in Everything
BunkerWeb 1.6.0-beta adds HTTP/3 HTTP/3 The third major version of HTTP, standardized by the IETF, which runs over QUIC instead of TCP, eliminating head-of-line blocking and reducing connection latency for faster, more resilient data transfer. limits, TOTP TOTP A one-time password algorithm (RFC 6238) that generates short-lived codes from a shared secret and the current time, giving cyber tools phishing-resistant second-factor authentication without a server round-trip. encryption, DNS prefetch control, and CoreRuleset plugin support via new env vars
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6.0-beta https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.6.0-beta
└──▷ TRY IT
Enable DNS prefetch control by setting the environment variable
copy
$ export X_DNS_PREFETCH_CONTROL=off
Encrypt TOTP secrets with a custom key to prevent data loss
copy
$ export TOTP_SECRETS=my_custom_secret_key_here
Configure BunkerWeb to use specific Kubernetes namespaces for autoconf
copy
$ export NAMESPACES=production,staging
Adds USE_MODSECURITY_CRS_PLUGINS and MODSECURITY_CRS_PLUGIN_URLS environment variables to automatically download and install Coreruleset plugins. Not checked yet Adds the X-DNS-Prefetch-Control header functionality with the X_DNS_PREFETCH_CONTROL setting (default is off) to control DNS prefetching behavior. Not checked yet Adds a new securitytxt plugin to manage the security.txt file from settings and serve it. Not checked yet Adds the REVERSE_PROXY_PASS_REQUEST_BODY setting to control if the request body should be passed to the upstream server (default is yes). Not checked yet Allows controlling job history size via the DATABASE_MAX_JOBS_RUNS setting (default is 10000), with future UI visibility. Not checked yet
+15 more
show less
Adds HTTP/3 connections limiting via the HTTP3_CONNECTIONS_LIMIT setting (default is 100) in the limit plugin. Not checked yet Adds a new templating feature to quickly override default values of settings and custom configurations, including UI steps for service configuration. Not checked yet Allows setting a custom timezone for every service via the TZ environment variable, applying to logs and database date fields. Not checked yet Enables running plugins jobs in async mode by setting the async key to true in the plugin job configuration (default is false). Not checked yet Adds Let's Encrypt DNS challenges support. Not checked yet Adds the REMOTE_PHP_PORT setting to control the port used by the remote PHP feature (default is 9000). Not checked yet Updates the scheduler to use the BUNKERWEB_INSTANCES environment variable (replacing OVERRIDE_INSTANCES) for instance configuration. Not checked yet Adds the NAMESPACES environment variable to the autoconf feature for setting namespaces to watch in multi-instance clusters. Not checked yet Adds the USE_KUBERNETES_FQDN environment variable (default is yes) to use FQDNs instead of IPs for instance hostnames in Kubernetes. Not checked yet Adds support for Fedora 41 and drops support for Fedora 40. Not checked yet Refactors the UI to be more modular and easier to maintain. Not checked yet Adds a remember me feature to the login page, keeping users logged in for 31 days. Not checked yet Adds the TOTP_SECRETS setting to encrypt TOTP secrets in the database; recommends setting a custom value to prevent erasure on volume deletion. Not checked yet Makes the 2FA 2FA Two-Factor Authentication, an authentication scheme requiring a second proof of identity beyond a password, so a stolen credential alone cannot grant access. feature more user-friendly and adds recovery codes for lost access. Not checked yet Refactors UI log handling to read directly from /var/log/bunkerweb instead of using integration-specific logic. Not checked yet
20 details in Everything
└──▷ BREAKING ON UPGRADE
! Fedora 40 is no longer supported; systems on Fedora 40 must migrate to Fedora 41 or another supported platform.
advisory CVE-2024-53264
Nov 27, 2024
·
issue 128
CVE-2024-53264: Open Redirect Vulnerability in Loading Page (affects <=1.5.11)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
BunkerWeb v1.5.11 adds worker dict size control and API timeout settings, plus updates OWASP CRS OWASP CRS A free, community-maintained ruleset for ModSecurity and compatible WAFs that detects common web attacks like SQLi and XSS, giving cyber tools a ready-made detection baseline without writing rules from scratch. to v4.8.0 and v3.3.7.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.11 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.11
New WORKERLOCK_MEMORY_SIZE setting lets operators tune the worker dictionary memory size. Not checked yet New API_TIMEOUT and API_READ_TIMEOUT settings enable fine-grained control over API timeout behaviour. Not checked yet Updates OWASP OWASP A nonprofit foundation that publishes open standards, guides, and ranked vulnerability lists—most famously the OWASP Top 10—giving cyber tools a vendor-neutral benchmark to test or report against. Core Rule Set v4 to v4.8.0 and v3 to v3.3.7, bringing the latest WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. detection rules. Not checked yet
3 details in Everything
BunkerWeb v1.5.9 adds SNI SNI A TLS extension that lets a client declare which hostname it is connecting to during the handshake, allowing one server to host multiple certificates on a single IP address. -based upstream support with new REVERSE_PROXY_SSL_SNI settings.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.9 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.9
└──▷ USE IT
Route traffic to an upstream that requires a specific TLS SNI value (e.g., a CDN CDN A content delivery network, servers distributed across locations that cache and serve content near readers. It can reduce loading time and traffic to the original server. or shared-hosting backend that serves multiple certs).
ini
copy
REVERSE_PROXY_SSL_SNI=yes
REVERSE_PROXY_SSL_SNI_NAME=backend.example.com
Adds REVERSE_PROXY_SSL_SNI and REVERSE_PROXY_SSL_SNI_NAME settings to support SNI-based TLS upstream connections in reverse proxy configurations. Not checked yet Updates the web UI setup wizard to handle scenarios where a reverse proxy already exists but no admin user is configured. Not checked yet Moves Linux package repository to repo.bunkerweb.io. Not checked yet Updates CoreRuleSet to v4.5.0, bringing the latest WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. detection rules. Not checked yet Updates security headers on default and error pages for improved posture. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Linux packages are now served from repo.bunkerweb.io instead of the previous packagecloud.io repository — existing package manager configurations pointing to the old repo URL must be updated.
Adds DATABASE_URI_READONLY fallback, HTTP/3 HTTP/3 The third major version of HTTP, standardized by the IETF, which runs over QUIC instead of TCP, eliminating head-of-line blocking and reducing connection latency for faster, more resilient data transfer. support, and nightly OWASP CRS OWASP CRS A free, community-maintained ruleset for ModSecurity and compatible WAFs that detects common web attacks like SQLi and XSS, giving cyber tools a ready-made detection baseline without writing rules from scratch. builds to BunkerWeb v1.5.8
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.8 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.8
Add automatic fallback to either read-only on the primary database or to the read-only database URI when the main database URI is not available and automatically switch back to the main database URI when it becomes available again Not checked yet Add new DATABASE_URI_READONLY setting to allow setting up a fallback read-only database URI in case the main database URI is not available Not checked yet Enhance security on error pages, default server page and loading page by adding a custom Content-Security-Policy header with nonces and removing the Server header Not checked yet Add experimental support of HTTP/3 (QUIC QUIC A UDP-based transport protocol standardized by the IETF that bakes in TLS 1.3, multiplexed streams, and connection migration, giving cyber tools low-latency encrypted transport without head-of-line blocking. ) Not checked yet Add nightly build of the OWASP OWASP A nonprofit foundation that publishes open standards, guides, and ranked vulnerability lists—most famously the OWASP Top 10—giving cyber tools a vendor-neutral benchmark to test or report against. coreruleset that are automatically downloaded and updated Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Drop support for Fedora 39 in favor of Fedora 40
BunkerWeb 1.5.7 adds a backup/restore plugin, LETS_ENCRYPT_CLEAR_OLD_CERTS and DISABLE_DEFAULT_SERVER_STRICT_SNI settings, and custom bwcli command support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.7 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.7
Adds the backup plugin to allow easy database backup and restore operations Not checked yet Adds LETS_ENCRYPT_CLEAR_OLD_CERTS environment variable (default: no) to control removal of old Let's Encrypt certificates during generation Not checked yet Adds DISABLE_DEFAULT_SERVER_STRICT_SNI environment variable (default: no) to permit or block requests when the SNI SNI A TLS extension that lets a client declare which hostname it is connecting to during the handshake, allowing one server to host multiple certificates on a single IP address. header is unknown or unset Not checked yet Enables custom bwcli commands via plugins, expanding the CLI tool surface Not checked yet Supports Ubuntu 24.04 (Noble) as a new Linux distribution target Not checked yet
+1 more
show less
Adds combobox plugin search on the Global config / services page for faster plugin discovery Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! Drops support for ansible and vagrant integrations
BunkerWeb v1.5.6 adds metrics plugin, Redis Sentinel, new UI pages, and several settings like REDIS_SSL_VERIFY
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.6 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.6
└──▷ HOW TO FIND IT
Disable SSL SSL A cryptographic protocol for encrypting network connections, now deprecated in favor of TLS but whose name persists colloquially. Cyber tools reference it when handling HTTPS or other encrypted-channel inspection and termination. certificate verification for Redis connections in BunkerWeb config.
📍 REDIS_SSL_VERIFY=False
Control SQLAlchemy logger verbosity independently of the main log level via environment variable.
📍 DATABASE_LOG_LEVEL=DEBUG
Send a custom Host header for reverse proxy targets using the new setting.
📍 REVERSE_PROXY_CUSTOM_HOST=example.com
Adds REDIS_SSL_VERIFY setting to activate/disable SSL certificate verification when using Redis Not checked yet Adds automatic Redis Sentinel fallback to master if no slaves are available Not checked yet Adds Redis Sentinel support for bwcli Not checked yet Adds new Metrics core plugin that allows metrics collection and retrieval of internal metrics Not checked yet Adds DATABASE_LOG_LEVEL setting to control SQLAlchemy loggers separately from the main one Not checked yet
+5 more
show less
Adds whitelist check for the default-server as well Not checked yet Adds ability to choose between coreruleset v3 and v4 for ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. (default is v3) Not checked yet Adds TIMERS_LOG_LEVEL setting to control the log level of the lua timers Not checked yet Adds pro version management to core plugins, the scheduler and the web UI Not checked yet Adds REVERSE_PROXY_CUSTOM_HOST setting to set a custom Host header when using reverse proxy Not checked yet
10 details in Everything
BunkerWeb v1.5.5 adds 2FA 2FA Two-Factor Authentication, an authentication scheme requiring a second proof of identity beyond a password, so a stolen credential alone cannot grant access. to the Web UI, Anonymous reporting, Redis Sentinel support, and configurable reverse proxy includes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.5 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.5
└──▷ HOW TO FIND IT
Inject custom Nginx include directives into reverse proxy blocks via environment variable.
📍 REVERSE_PROXY_INCLUDES=/etc/bunkerweb/custom-includes/*.conf docker compose up -d
Enable Two-Factor Authentication for the BunkerWeb Web UI administrators.
📍 In the BunkerWeb UI, navigate to Settings › Users and enable 2FA for your account.
Adds REVERSE_PROXY_INCLUDES environment variable to manually inject include directives into reverse proxy configurations Not checked yet Adds 2FA support for authentication in the BunkerWeb Web UI Not checked yet Adds Anonymous reporting feature for system health statistics Not checked yet Adds Redis Sentinel support for high-availability Redis deployments Not checked yet
4 details in Everything
BunkerWeb v1.5.4 adds an optional setup wizard to the web UI and extends Linux package support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.4 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.4
Supports Debian 12, Fedora 39 and RHEL RHEL Red Hat Enterprise Linux, a commercially supported Linux distribution maintained by Red Hat, chosen by cyber tools for its long support lifecycle, certified hardware compatibility, and enterprise deployment prevalence. 8.9 via Linux packages Not checked yet
1 detail in Everything
BunkerWeb v1.5.2 adds ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. JSON LogFormat support and publishes Docker images to ghcr.io.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.2 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.2
ghcr.io/bunkerity/bunkerweb:* Docker tags are now available for BunkerWeb components Not checked yet Supports ModSecurity JSON LogFormat for log output configuration Not checked yet
2 details in Everything
BunkerWeb 1.5.2 adds ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. JSON LogFormat support and GitHub Container Registry publishing.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.5.2 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.5.2
Push Docker images to GitHub packages (ghcr.io repository) Not checked yet
1 detail in Everything
v1.5.1 adds Turnstile antibot mode, custom redirect status codes, header preservation, and local plugin downloads.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.1 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.1
└──▷ TRY IT
Force permanent redirects (301) instead of the default temporary redirect when using reverse proxy.
copy
$ REDIRECT_TO_STATUS_CODE=301 bunkerweb
Preserve original upstream headers in your response while acting as a reverse proxy.
copy
$ KEEP_UPSTREAM_HEADERS=yes bunkerweb
Load external plugins from a local tar.gz archive instead of fetching them over the network.
copy
$ PLUGIN_URL=file:///path/to/plugin.tar.gz
REDIRECT_TO_STATUS_CODE environment variable to choose between 301 and 302 for redirects Not checked yet KEEP_UPSTREAM_HEADERS to preserve headers when using reverse proxy Not checked yet Turnstile antibot mode support Not checked yet Download lists and plugins from a local file instead of remote sources Not checked yet Support for tar.gz and tar.xz files for external plugins Not checked yet
5 details in Everything
BunkerWeb v1.5.0 introduces a dedicated scheduler service, database-backed configuration, RHEL RHEL Red Hat Enterprise Linux, a commercially supported Linux distribution maintained by Red Hat, chosen by cyber tools for its long support lifecycle, certified hardware compatibility, and enterprise deployment prevalence. integration, and initial TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. /UDP UDP A network protocol that sends individual messages without guaranteeing delivery or order. Applications trade built-in reliability for less overhead and can add their own recovery. stream support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.5.0 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.5.0
└──▷ USE IT
Deploy the new dedicated scheduler component alongside BunkerWeb to manage background jobs.
shell
copy
docker pull bunkerity/bunkerweb-scheduler:1.5.0
Adds bunkerity/bunkerweb-scheduler:1.5.0 Docker tag for the new dedicated scheduler service managing jobs and configuration Not checked yet Enables storing configuration in a database backend instead of flat files Not checked yet Adds RHEL integration support Not checked yet Initializes support for generic TCP/UDP (stream) protocols Not checked yet Initiates support for IPv6 IPv6 The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. Not checked yet
+2 more
show less
Adds Redis support for clustered integrations Not checked yet Adds Vagrant integration Not checked yet
7 details in Everything
BunkerWeb v1.5.0-beta adds Redis for clustered integrations, RHEL RHEL Red Hat Enterprise Linux, a commercially supported Linux distribution maintained by Red Hat, chosen by cyber tools for its long support lifecycle, certified hardware compatibility, and enterprise deployment prevalence. and Vagrant support, and initial IPv6 IPv6 The current version of the Internet Protocol, standardized by the IETF, using 128-bit addresses to replace the exhausted IPv4 space. Cyber tools target it because modern networks run dual-stack or IPv6-only. /TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. /UDP UDP A network protocol that sends individual messages without guaranteeing delivery or order. Applications trade built-in reliability for less overhead and can add their own recovery. stream capabilities.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.5.0-beta https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.5.0-beta
Add Redis support when using clustered integrations allows backend configuration caching for scaled deployments Not checked yet Add RHEL integration enables deployment on Red Hat Enterprise Linux systems Not checked yet Add Vagrant integration provides a ready-made development environment setup Not checked yet Init support of generic TCP/UDP (stream) extends the proxy to handle non-HTTP protocols Not checked yet Init support of IPv6 allows binding and traffic handling over IPv6 networks Not checked yet
5 details in Everything
BunkerWeb v1.4.4 adds greylisting, Blacklist ignore settings, ModSecurity ModSecurity An open-source web application firewall engine, maintained by the OWASP community, that inspects HTTP traffic against rule sets to block malicious requests before they reach an application. limits, API manual bans, and new env vars
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.4.4 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.4.4
└──▷ TRY IT
Use the CLI to manually ban an IP address
copy
$ bwcli ban 192.168.1.100
Adds greylist core feature to allow temporary bypass of blocking rules for trusted sources Not checked yet Adds BLACKLIST_IGNORE_* settings to exclude specific IPs or ranges from global blacklists Not checked yet Add automatic change of SecRequestBodyLimit modsec directive based on MAX_CLIENT_SIZE setting Not checked yet Add MODSECURITY_SEC_RULE_ENGINE and MODSECURITY_SEC_AUDIT_LOG_PARTS settings Not checked yet
4 details in Everything
BunkerWeb v1.4.3 adds CORS CORS A browser mechanism that lets a server declare which foreign origins may read its HTTP responses, enforced by the browser to block unauthorized cross-site requests from JavaScript. plugin, custom conf injection, Deny status control, and Ansible integration
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.4.3 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.4.3
Adds *_CUSTOM_CONF_* setting to automatically inject custom configuration files from the environment variable value Not checked yet Adds DENY_HTTP_STATUS setting to allow choosing between standard 403 error page or 444 (close connection) when access is denied Not checked yet Adds CORS (Cross-Origin Resource Sharing) as a core plugin Not checked yet Adds Ansible integration in beta Not checked yet
4 details in Everything
BunkerWeb v1.4.2 adds EXTERNAL_PLUGIN_URLS setting for auto-installing external plugins
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.4.2 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.4.2
Adds reverse_proxy_timeout and auth_request settings with authentik/authelia examples
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.4.1 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.4.1
Add reverse proxy timeouts settings to allow configuring timeout values for upstream connections Not checked yet Add auth_request settings to configure Nginx auth_request module parameters for authentication offloading Not checked yet Add authentik and authelia examples demonstrating integration with these specific identity providers identity providers A service that authenticates users and supplies identity information to other applications. It is the sign-in authority behind many single sign-on systems. Not checked yet
3 details in Everything
BunkerWeb v1.4.0 adds a modular architecture, Linux packages, and a new settings generation tool
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.4.0 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.4.0
Project renamed to BunkerWeb Not checked yet Internal architecture fully revised with a modular approach Not checked yet Plugin improvement Not checked yet Volume improvement for container-based integrations Not checked yet Web UI improvement with various new features Not checked yet
+1 more
show less
Web tool to generate settings from a user-friendly UI Not checked yet
6 details in Everything
Adds Swarm/K8s K8s Shorthand for Kubernetes, the open-source container orchestration system originally from Google; cyber tools use it to deploy, scale, and manage containerized workloads across clusters. API integration, distributed bad IPs database via remote API, and expanded request limiting.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.3.2 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.3.2
Use API instead of a shared folder for Swarm and Kubernetes integrations Not checked yet Beta integration of distributed bad IPs database through a remote API Not checked yet Improvement of the request limiting feature : hour/day rate and multiple URL support Not checked yet
3 details in Everything
BunkerWeb v1.3.1 adds CUSTOM_HEADER, REVERSE_PROXY_BUFFERING, and REVERSE_PROXY_KEEPALIVE environment variables for reverse proxy control.
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.3.1 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.3.1
Adds CUSTOM_HEADER variable to inject custom headers into proxied requests Not checked yet Adds REVERSE_PROXY_BUFFERING variable to control buffering behavior in reverse proxy mode Not checked yet Adds REVERSE_PROXY_KEEPALIVE variable to manage keep-alive connections for the reverse proxy Not checked yet
3 details in Everything
BunkerWeb v1.3.0 adds Kubernetes/Linux integrations in beta, Authelia support, and new configuration variables
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.3.0 https://github.com/bunkerity/bunkerweb.git
$ git checkout v1.3.0
└──▷ TRY IT
Configure BunkerWeb to use a custom response body via the environment
copy
$ # Add INJECT_BODY to your .env or docker-compose.yml
INJECT_BODY='<!-- Custom Footer -->'
Enable Authelia integration by setting the appropriate environment variable
copy
$ # Add AUTH_ENGINE=authelia to your .env or docker-compose.yml
AUTH_ENGINE=authelia
Point redirects to a specific URL using the new variable
copy
$ # Add REDIRECT_TO to your .env or docker-compose.yml
REDIRECT_TO=https://example.com/new-location
Adds INJECT_BODY variable to customize response payloads Not checked yet Adds WORKER_PROCESSES variable to control Nginx worker count Not checked yet Adds USE_LETS_ENCRYPT_STAGING variable for Let's Encrypt staging environment Not checked yet Adds LOCAL_PHP and LOCAL_PHP_PATH variables for local PHP configuration Not checked yet Adds REDIRECT_TO variable for URL redirection Not checked yet
+3 more
show less
Adds Authelia integration support for authentication Not checked yet Introduces Kubernetes integration Beta as a new deployment target Not checked yet Introduces Linux integration Beta for standalone server deployment Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! CrowdSec is now an external plugin rather than a built-in feature
Adds custom robots.txt/sitemap in RTD, HEALTHCHECK support, pre/post job split, and underscore in cert paths.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.2.7 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.2.7
Add HEALTHCHECK to image Not checked yet
1 detail in Everything
BunkerWeb 1.2.6 adds LOG_LEVEL env var, read-only container support, and a plugin system init.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.2.6 https://github.com/bunkerity/bunkerweb.git
$ git checkout 1.2.6
Adds LOG_LEVEL environment variable to control logging verbosity Not checked yet Enables read-only container execution mode Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! ClamAV functionality is now provided via an external plugin rather than being built-in