Rate Limiting
RateLimit throttles requests per client IP with a shared counter across
all OLS workers.
Directives
Section titled “Directives”| Directive | Syntax |
|---|---|
RateLimit | N/M [burst=B] [action=deny|throttle|log] |
N/M— allow N requests per M secondsburst=B— tolerate B requests above the limit before actingaction=— what to do when exceeded (defaultdeny)deny→ 403 immediatelythrottle→ 429 +Retry-After(never delays the worker)log→ count only, serve normally
Example
Section titled “Example”RateLimit 100/60100 requests per minute per IP; the 101st within the window is denied with 403.
RateLimit 10/10 burst=5 action=throttleBehaviour
Section titled “Behaviour”| Action | Effect |
|---|---|
deny | 403 immediately |
throttle | progressive delay, then 429 |
log | count and log, but serve |
Counters are namespaced separately from brute-force protection — heavy browsing never feeds login-failure thresholds.