:entrypoints
| Map of entrypoint ids to entrypoint maps (see below). |
:dispatch
| Ordered vector of dispatcher maps (see below). |
:tls
| Global TLS, certificate, ACME, and session ticket config (see below). |
:n-workers
| Positive integer event loop worker count. The default is half the processors available to the JVM, rounded down, at least 2 and at most 8. |
:worker-hot-poll-micros
| Non-negative integer, default 0. Longest time in microseconds that a worker with live requests polls for new work before it sleeps. 0 disables the poll. A positive value such as 50 lowers latency when handlers finish inside it, and costs up to that much worker CPU per idle gap. |
:request-threads
| :per-request (default) or :reuse-within-connection. :per-request runs every request on a new virtual thread. :reuse-within-connection lets quick requests of one connection run one after another on one virtual thread, which can help many quick HTTP/2 and HTTP/3 requests per connection on machines with many CPUs. Anything bound to the thread then stays for the next request of that connection. See Sharing virtual threads within a connection.
|
:max-connections
| Positive integer connection cap, default 1024. |
:output-buffer-size
| Positive response byte budget and native streaming block size, default 32768. Zero is invalid. |
:fixed-response-max-body-size
| Largest body in bytes that a fixed-response slot takes, 1 to Integer/MAX_VALUE, default 32768. The limit is the smaller of this and :output-buffer-size. See Output storage and backpressure. |
:fixed-response-slots
| Fixed-response slots per worker, 1 to 65535, default 256. See Output storage and backpressure. |
:large-response-head-warnings?
| Boolean, default true. Logs at most one :ol.busker.response/large-head warning a minute for response heads that do not fit a fixed-response slot. |
:server-name
| Server header value, default "ol.busker/dev". |
:proxy-status-identity
| Optional Proxy-Status identity. |
:max-request-entity-size
| Optional positive integer request body byte limit. |
:max-delegations
| Optional positive integer internal delegation limit. |
:max-reprocesses
| Optional positive integer internal reprocess limit. |
:handshake-timeout
| Optional TLS handshake timeout in milliseconds. |
:max-spare-pipes
| Optional non-negative idle pipe cache limit. |
:http1-req-timeout
| Optional HTTP/1.1 request timeout in milliseconds. |
:http1-req-io-timeout
| Optional HTTP/1.1 request I/O timeout in milliseconds. See HTTP/1 streaming timeouts. |
:http1-upgrade?
| Allow h2c upgrade, default true. |
:http1-req-io-timeout-while-generating?
| Also run :http1-req-io-timeout while a response waits for the application’s next output, default false. See HTTP/1 streaming timeouts. |
:http2-idle-timeout
| Optional HTTP/2 idle timeout in milliseconds. |
:http2-graceful-shutdown-timeout
| Optional HTTP/2 graceful shutdown timeout in milliseconds. |
:http2-max-streams
| Optional positive integer concurrent HTTP/2 stream limit. |
:http2-max-requests
| Optional positive integer concurrent HTTP/2 request limit. |
:http2-max-streaming-requests
| Optional positive integer streaming request limit. |
:http2-max-priority-streams
| Optional positive integer priority stream tracking limit. |
:http2-stream-window-size
| Optional positive integer per-stream window bytes. |
:http2-dos-delay
| Optional suspicious behavior delay in milliseconds. |
:http3-idle-timeout
| Optional HTTP/3 idle timeout in milliseconds. |
:http3-graceful-shutdown-timeout
| Optional HTTP/3 graceful shutdown timeout in milliseconds. |
:http3-stream-window-size
| Optional positive integer per-stream window bytes. |
:http3-ack-frequency
| Optional non-negative ACK frequency; 0 uses the QUIC default. |
:compress?
| Enable response compression, default true. |
:compress-min-size
| Minimum response bytes for compression, default 100. |
:compress-gzip-level
| Gzip level 0 through 9, default 1. |
:compress-brotli-level
| Brotli level 0 through 11, default 1. |
:compress-zstd-level
| Zstandard compression level, default 3. |