Jetty 12

:daemon?

Boolean

Use daemon threads. Defaults to false.

:context-path

String

Context path for the application; must start with a /. Defaults to /.

:max-threads

Integer

The maximum number of threads to use. Defaults to 50.

:max-streams

Integer

The maximum number of concurrent streams for an HTTP2 or HTTP2C connector. Defaults to 128.

:reuse-addr?

Boolean

Reuse the socket address. Defaults to true.

:thread-pool

A ThreadPool instance.

Override the Jetty thread pool (ignores max-threads)

:configurator

Function

A function called with the Server instance. Expected to return the Server instance. Use when advanced customization is required.

:context-configurator

Function

A function called with the ServletContextHandler instance. Use when advanced customization is required.

:ssl?

Boolean

Allows connections over HTTPS.

:ssl-port

Integer

Port to use for TLS listener. Defaults to 443 and implies :ssl?.

:h2c?

Boolean

HTTP/2 cleartext support. Allows upgrading connections from HTTP/1.1 to the Http/2 protocol. Defaults to true.HTTP/2 versioning, Jetty HTTP/2 documentation.

:h2?

Boolean

HTTP/2 TLS support. When true, :ssl-port must also be specified.

:connection-factory-fns

Vector of Functions

A vector of functions that each take the options map and an HttpConfiguration instance and return a ConnectionFactory instance. Applies only to the SSL connection.

:ssl-context-factory

An SslContextFactory instance.

The SSLContextFactory instance to use when creating the server. If specified, :key-password, :keystore, :truststore, :trust-password, :security-provider, :client-auth are ignored.

:keystore

String or java.security.Keystore

Used for TLS. Path to keystore file or a java.security.Keystore instance. Not used if :ssl-context-factory is set.

:key-password

String

Used for TLS. Keystore password. Not used if :ssl-context-factory is set.

:truststore

String or java.security.Keystore

Used for TLS. Path to keystore file or a java.security.Keystore instance. Not used if :ssl-context-factory is set.

:trust-password

String

Used for TLS. Trust store password. Not used if :ssl-context-factory is set.

:sni-host-check?

Boolean

Perform Server Name Indication check during TLS handshake (default true). Set this to false for local development and when using DNS wildcard certificates since "localhost" is not a valid server name according to the TLS spec and the definitive server name is not known when using a DNS wildcard certificate after the TLS handshake. You will receive HTTP 400 statuses from the browser when this is enabled and you use localhost or a DNS wildcard certificate.

:keystore-scan-interval

Integer

The interval in seconds to scan for an updated keystore/certificate replacement (default 60). This is only relevant when SSL is configured. When the keystore is updated, the service will reload certificates with no downtime.

:client-auth

String

SSL client certificate authenticate, may be set to :need, :want or :none. Defaults to :none.

:security-provider

String

Java Security Provider name. Refer to the Jetty Configuring SSL/TLS documentation. Not used if :ssl-context-factory is set.

:http-configuration

An HttpConfiguration instance.

The HttpConfiguration instance to use when creating the server. Use when advanced customization is required. The default HttpConfiguration is listed below.

:ws-idle-timeout

long

Sets the default time in milliseconds after which any web socket sessions in this container will be closed if it has been inactive, or 0 for no timeout.

:ws-max-binary-size

long

Sets the default maximum size of incoming binary message that this container will buffer.

:ws-max-text-size

long

Sets the maximum size of incoming text message that this container will buffer.