Configuration Reference
Version:4.10.2
Micronaut Buffer Netty Config Properties
🔗Property | Type | Description |
---|---|---|
|
java.lang.Integer |
The number of heap arenas |
|
java.lang.Integer |
The number of direct arenas |
|
java.lang.Integer |
The page size |
|
java.lang.Integer |
The max order |
|
java.lang.Integer |
The chunk size |
|
java.lang.Integer |
The small cache size |
|
java.lang.Integer |
The normal cache size |
|
java.lang.Boolean |
Whether to use the cache for all threads |
|
java.lang.Integer |
The max cached buffer capacity |
|
java.lang.Integer |
The cache trim interval |
|
java.lang.Integer |
The max cached byte buffers per chunk |
Micronaut Context Config Properties
🔗Property | Type | Description |
---|---|---|
|
boolean |
Whether to enable graceful shutdown on normal shutdown. Off by default. |
|
java.time.Duration |
Duration to wait until forcing a shutdown. |
Property | Type | Description |
---|---|---|
|
java.lang.Integer |
number of threads |
|
the type |
|
|
java.lang.Integer |
the parallelism |
|
java.lang.Integer |
the core pool size |
|
java.lang.Boolean |
whether to use virtual threads |
|
java.lang.Class |
the thread factory class |
|
java.lang.String |
Sets the executor name. |
|
java.lang.Integer |
Sets the number of threads for FIXED. Default value (2 * Number of processors available to the Java virtual machine). |
Property | Type | Description |
---|---|---|
|
boolean |
Whether watch is enabled. |
|
boolean |
Set whether restart is enabled. |
|
java.util.List |
Sets the watch paths to use. |
|
java.time.Duration |
Sets the interval to wait between file watch polls. |
Property | Type | Description |
---|---|---|
|
java.nio.charset.Charset |
Default value (UTF-8). |
|
java.lang.String |
The application name |
Property | Type | Description |
---|---|---|
|
java.lang.String |
An optional instance identifier |
|
java.util.Map |
Any metadata to associate with the instance |
|
java.lang.String |
The instance auto-scaling group |
|
java.lang.String |
The instance availability zone. For example, it’s possible to configure Netflix Ribbon to load balance between servers only in a particular zone |
Micronaut Discovery Core Config Properties
🔗Property | Type | Description |
---|---|---|
|
java.time.Duration |
Default value (15 seconds). |
|
boolean |
Default value (true). |
Property | Type | Description |
---|---|---|
|
boolean |
Default value (true). |
|
java.lang.String |
Default value ("http://169.254.169.254/metadata/v1.json"). |
Micronaut Function Config Properties
🔗Property | Type | Description |
---|---|---|
|
boolean |
Sets whether to use the default binary types. |
|
java.util.List |
Sets the additional media types to consider binary. |
Micronaut Http Client Core Config Properties
🔗Property | Type | Description |
---|---|---|
|
Sets the HTTP version to use. Defaults to {@link HttpVersion#HTTP_1_1}. |
|
|
Sets the level to enable trace logging at. Depending on the implementation this may activate additional handlers. For example in Netty this will activate {@code LoggingHandler} at the given level. |
|
|
java.lang.String |
The event loop group to use. |
|
Sets the SSL configuration for the client. |
|
|
boolean |
Sets whether redirects should be followed. Default value (DEFAULT_FOLLOW_REDIRECTS). |
|
boolean |
Sets whether throwing an exception upon HTTP error status (>= 400) is preferred. Default value (DEFAULT_EXCEPTION_ON_ERROR_STATUS) |
|
boolean |
Enable or disable automatic response content decompression in the Netty HTTP client. Disabling this can be useful for proxy or testing scenarios where the compressed payload and Content-Encoding header need to be observed. |
|
java.lang.String |
Sets the client-specific logger name. |
|
java.nio.charset.Charset |
Sets the default charset to use. Default value (UTF-8); |
|
java.util.Map |
The Client channel options. |
|
java.time.Duration |
Sets the read timeout. Default value (10 seconds). |
|
java.time.Duration |
The request timeout for non-streaming requests. This is the maximum time until the response must be completely received. Defaults to one second more than read-timeout. |
|
java.time.Duration |
For WebSockets, the {@link #getReadTimeout()} method does not apply instead a configurable idle timeout is applied. |
|
java.time.Duration |
Sets the idle timeout for connection in the client connection pool. Defaults to 0. |
|
java.time.Duration |
Sets the connect timeout. |
|
java.time.Duration |
Sets the connect timeout. |
|
java.time.Duration |
Sets the amount of quiet period for shutdown of client thread pools. Default value (1 milliseconds). If a task is submitted during the quiet period, it will be accepted and the quiet period will start over. |
|
java.time.Duration |
Sets the amount of time to wait for shutdown of client thread pools. Default value (100 milliseconds). |
|
java.lang.Integer |
Sets the number of threads the client should use for requests. |
|
java.lang.Class |
Sets a thread factory. |
|
int |
Sets the maximum content length the client can consume. Default value (1024 * 1024 * 10 => 10MB). |
|
int |
Sets the maximum header size the client can handle. Default value (8192). |
|
java.net.Proxy$Type |
The proxy type |
|
java.net.SocketAddress |
Sets a proxy address. |
|
java.lang.String |
Sets the proxy username to use. |
|
java.lang.String |
Sets the proxy password. |
|
java.net.ProxySelector |
Sets the proxy selector. ProxySelector decides what proxy to use and take precedence over {@link #setProxyAddress(SocketAddress)} and {@link #setProxyType(Proxy.Type)}. |
|
The connection mode to use for <i>plaintext</i> (http as opposed to https) connections. <br> <b>Note: If {@link #httpVersion} is set, this setting is ignored!</b> |
|
|
java.util.List |
The protocols to support for TLS ALPN. If HTTP 2 is included, this will also restrict the TLS cipher suites to those supported by the HTTP 2 standard. <br> <b>Note: If {@link #httpVersion} is set, this setting is ignored!</b> |
|
boolean |
Whether to allow blocking a netty event loop with a call to {@link BlockingHttpClient}. When this is off (the default), any calls that block an event loop will throw an error. Such calls are almost always a mistake that can lead to hard-to-debug transient issues such as read timeouts. Only enable this setting if you are sure you won’t hit such a bug. <br> Default value: {@value DEFAULT_ALLOW_BLOCK_EVENT_LOOP} |
|
Configure how DNS records are resolved. Ignored if {@link #getAddressResolverGroupName()} is non-null. This option is specific to the netty client. |
|
|
java.lang.String |
Name of a fixed netty AddressResolverGroup to use for this client, or {@code null} to instead use {@link #getDnsResolutionMode()}. This option is specific to the netty client. |
|
java.lang.String |
The path pattern to use for logging outgoing connections to pcap. This is an unsupported option: Behavior may change, or it may disappear entirely, without notice! Only implemented for netty. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether the per message deflate extension is enabled for WebSocket connections. Default value (DEFAULT_ENABLED). |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether connection pooling is enabled. Default value (true). |
|
int |
Sets the max pending acquires. |
|
java.time.Duration |
Sets the timeout to wait for a connection. |
|
int |
The maximum number of <i>pending</i> (new) connections before they are assigned to a pool. |
|
int |
The maximum number of requests (streams) that can run concurrently on one HTTP2 connection. |
|
int |
The maximum number of concurrent HTTP1 connections in the pool. |
|
int |
The maximum number of concurrent HTTP2 connections in the pool. |
|
HttpClientConfiguration$ConnectionPoolConfiguration$ConnectionLocality |
Optimize locality of client connections depending on which event loop makes a request. [available in the Netty HTTP client] |
|
HttpClientConfiguration$ConnectionPoolConfiguration$PoolVersion |
The version of the connection pool implementation. Defaults to {@code V4_9}, can be set to {@code V4_0} for compatibility. |
Property | Type | Description |
---|---|---|
|
Sets the HTTP version to use. Defaults to {@link HttpVersion#HTTP_1_1}. |
|
|
Sets the level to enable trace logging at. Depending on the implementation this may activate additional handlers. For example in Netty this will activate {@code LoggingHandler} at the given level. |
|
|
java.lang.String |
The event loop group to use. |
|
boolean |
Sets whether redirects should be followed. Default value (DEFAULT_FOLLOW_REDIRECTS). |
|
boolean |
Sets whether throwing an exception upon HTTP error status (>= 400) is preferred. Default value (DEFAULT_EXCEPTION_ON_ERROR_STATUS) |
|
boolean |
Enable or disable automatic response content decompression in the Netty HTTP client. Disabling this can be useful for proxy or testing scenarios where the compressed payload and Content-Encoding header need to be observed. |
|
java.lang.String |
Sets the client-specific logger name. |
|
java.nio.charset.Charset |
Sets the default charset to use. Default value (UTF-8); |
|
java.util.Map |
The Client channel options. |
|
java.time.Duration |
Sets the read timeout. Default value (10 seconds). |
|
java.time.Duration |
The request timeout for non-streaming requests. This is the maximum time until the response must be completely received. Defaults to one second more than read-timeout. |
|
java.time.Duration |
For WebSockets, the {@link #getReadTimeout()} method does not apply instead a configurable idle timeout is applied. |
|
java.time.Duration |
Sets the idle timeout for connection in the client connection pool. Defaults to 0. |
|
java.time.Duration |
Sets the connect timeout. |
|
java.time.Duration |
Sets the connect timeout. |
|
java.time.Duration |
Sets the amount of quiet period for shutdown of client thread pools. Default value (1 milliseconds). If a task is submitted during the quiet period, it will be accepted and the quiet period will start over. |
|
java.time.Duration |
Sets the amount of time to wait for shutdown of client thread pools. Default value (100 milliseconds). |
|
java.lang.Integer |
Sets the number of threads the client should use for requests. |
|
java.lang.Class |
Sets a thread factory. |
|
int |
Sets the maximum content length the client can consume. Default value (1024 * 1024 * 10 => 10MB). |
|
int |
Sets the maximum header size the client can handle. Default value (8192). |
|
java.net.Proxy$Type |
The proxy type |
|
java.net.SocketAddress |
Sets a proxy address. |
|
java.lang.String |
Sets the proxy username to use. |
|
java.lang.String |
Sets the proxy password. |
|
java.net.ProxySelector |
Sets the proxy selector. ProxySelector decides what proxy to use and take precedence over {@link #setProxyAddress(SocketAddress)} and {@link #setProxyType(Proxy.Type)}. |
|
The connection mode to use for <i>plaintext</i> (http as opposed to https) connections. <br> <b>Note: If {@link #httpVersion} is set, this setting is ignored!</b> |
|
|
java.util.List |
The protocols to support for TLS ALPN. If HTTP 2 is included, this will also restrict the TLS cipher suites to those supported by the HTTP 2 standard. <br> <b>Note: If {@link #httpVersion} is set, this setting is ignored!</b> |
|
boolean |
Whether to allow blocking a netty event loop with a call to {@link BlockingHttpClient}. When this is off (the default), any calls that block an event loop will throw an error. Such calls are almost always a mistake that can lead to hard-to-debug transient issues such as read timeouts. Only enable this setting if you are sure you won’t hit such a bug. <br> Default value: {@value DEFAULT_ALLOW_BLOCK_EVENT_LOOP} |
|
Configure how DNS records are resolved. Ignored if {@link #getAddressResolverGroupName()} is non-null. This option is specific to the netty client. |
|
|
java.lang.String |
Name of a fixed netty AddressResolverGroup to use for this client, or {@code null} to instead use {@link #getDnsResolutionMode()}. This option is specific to the netty client. |
|
java.lang.String |
The path pattern to use for logging outgoing connections to pcap. This is an unsupported option: Behavior may change, or it may disappear entirely, without notice! Only implemented for netty. |
|
java.util.List |
Sets the URIs of the service. |
|
java.net.URI |
Sets the URL of the service. |
|
java.lang.String |
Sets the health check URI. Default value ("/health"). |
|
boolean |
Sets whether the service health should be checked. Default value (false). |
|
java.lang.String |
Sets the context path to use for requests. |
|
java.time.Duration |
Sets the default duration to check health status. Default value (30 seconds). |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether connection pooling is enabled. Default value (true). |
|
int |
Sets the max pending acquires. |
|
java.time.Duration |
Sets the timeout to wait for a connection. |
|
int |
The maximum number of <i>pending</i> (new) connections before they are assigned to a pool. |
|
int |
The maximum number of requests (streams) that can run concurrently on one HTTP2 connection. |
|
int |
The maximum number of concurrent HTTP1 connections in the pool. |
|
int |
The maximum number of concurrent HTTP2 connections in the pool. |
|
HttpClientConfiguration$ConnectionPoolConfiguration$ConnectionLocality |
Optimize locality of client connections depending on which event loop makes a request. [available in the Netty HTTP client] |
|
HttpClientConfiguration$ConnectionPoolConfiguration$PoolVersion |
The version of the connection pool implementation. Defaults to {@code V4_9}, can be set to {@code V4_0} for compatibility. |
Property | Type | Description |
---|---|---|
|
Sets the SSL configuration for the client. |
|
|
boolean |
|
|
int |
|
|
||
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.time.Duration |
|
|
boolean |
|
|
boolean |
|
|
boolean |
Property | Type | Description |
---|---|---|
|
java.util.List |
The list of request header names. |
|
java.util.List |
The list of request query parameter names. |
Property | Type | Description |
---|---|---|
|
java.util.List |
The list of request header names. |
|
java.util.List |
The list of request query parameter names. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
Property | Type | Description |
---|---|---|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
|
|
java.lang.String |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether the per message deflate extension is enabled for WebSocket connections. Default value (DEFAULT_ENABLED). |
|
java.time.Duration |
For HTTP/2 connections, the interval from the last inbound message to when an automated ping should be sent. This can be used to keep low-traffic connections alive. |
|
java.time.Duration |
For HTTP/2 connections, the interval from the last outbound message to when an automated ping should be sent. This can be used to keep low-traffic connections alive. |
|
java.time.Duration |
For HTTP/2 connections, the interval from the last message (inbound or outbound) to when an automated ping should be sent. This can be used to keep low-traffic connections alive. |
Property | Type | Description |
---|---|---|
|
java.time.Duration |
For HTTP/2 connections, the interval from the last inbound message to when an automated ping should be sent. This can be used to keep low-traffic connections alive. |
|
java.time.Duration |
For HTTP/2 connections, the interval from the last outbound message to when an automated ping should be sent. This can be used to keep low-traffic connections alive. |
|
java.time.Duration |
For HTTP/2 connections, the interval from the last message (inbound or outbound) to when an automated ping should be sent. This can be used to keep low-traffic connections alive. |
Micronaut Http Config Properties
🔗Property | Type | Description |
---|---|---|
|
java.lang.String |
The path to the key store (typically .jks). Can also point to a PEM file containing a private key followed by the X.509 trust chain. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. |
|
java.lang.String |
Sets the password to use for the keystore. |
|
java.lang.String |
Sets the type of keystore. |
|
java.lang.String |
Sets the keystore provider name. |
|
java.lang.String |
A path to a PEM file containing the private key. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. Cannot be set at the same time as the {@code path} property. |
|
java.lang.String |
A path to a PEM file containing the certificate chain. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. Cannot be set at the same time as the {@code path} property. |
|
Sets the keystore configuration. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
The path to the key store (typically .jks). Can also point to a PEM file containing a private key followed by the X.509 trust chain. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. |
|
java.lang.String |
Sets the password to use for the keystore. |
|
java.lang.String |
Sets the type of keystore. |
|
java.lang.String |
Sets the keystore provider name. |
|
java.lang.String |
A path to a PEM file containing the private key. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. Cannot be set at the same time as the {@code path} property. |
|
java.lang.String |
A path to a PEM file containing the certificate chain. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. Cannot be set at the same time as the {@code path} property. |
|
Sets the keystore configuration. |
Property | Type | Description |
---|---|---|
|
boolean |
Whether SSL is enabled. Default value (false). |
|
int |
Sets the SSL port. Default value (8443). |
|
Sets the client authentication mode. |
|
|
java.lang.String |
Sets the ciphers to use. |
|
java.lang.String |
Sets the protocols to use. |
|
java.lang.String |
Name of a CertificateProvider bean that supplies the trust material (trusted certificates) for the SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates; when not set, the legacy {@code trust-store} configuration is used instead. May be combined with {@code keyName} to also source the key material from a provider. |
|
java.lang.String |
Sets the protocol to use. Default value ("TLS"). |
|
java.time.Duration |
The timeout for the SSL handshake |
|
boolean |
Sets whether to build a self-signed certificate. Default value (false). |
|
boolean |
Whether an OpenSSL-backed TLS implementation should be preferred if it’s on the classpath. {@code true} by default. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
Name of a CertificateProvider bean that supplies the private key and certificate chain for the SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates; when not set, the legacy {@code key}/{@code key-store} configuration is used instead. May be combined with {@code trustName} to also source the trust store from a provider. |
|
java.lang.String |
Sets the password. |
|
java.lang.String |
Sets the alias. |
Property | Type | Description |
---|---|---|
|
Explicit format of the certificate material. If not set, Micronaut will first try to load the file as a key store (JKS/PKCS12) and, if that fails, as PEM. A separate {@code certificatePath} can only be used with PEM. |
|
|
java.lang.String |
Password used to open the key store (JKS/PKCS12) or decrypt PEM private keys, if required. |
|
java.lang.String |
Micronaut resource location of the certificate material to load, for example {@code classpath:certs/server.p12} or {@code file:/etc/ssl/server.pem}. The actual format and password handling are controlled by the common properties in {@link AbstractCertificateFileConfig} (e.g. {@code format}, {@code password}). |
Property | Type | Description |
---|---|---|
|
java.lang.String |
The path to the key store (typically .jks). Can also point to a PEM file containing a private key followed by the X.509 trust chain. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. |
|
java.lang.String |
Sets the password to use for the keystore. |
|
java.lang.String |
Sets the type of keystore. |
|
java.lang.String |
Sets the keystore provider name. |
|
java.lang.String |
A path to a PEM file containing the private key. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. Cannot be set at the same time as the {@code path} property. |
|
java.lang.String |
A path to a PEM file containing the certificate chain. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. Cannot be set at the same time as the {@code path} property. |
Property | Type | Description |
---|---|---|
|
boolean |
Whether SSL is enabled. Default value (false). |
|
int |
Sets the SSL port. Default value (8443). |
|
Sets the client authentication mode. |
|
|
java.lang.String |
Sets the ciphers to use. |
|
java.lang.String |
Sets the protocols to use. |
|
java.lang.String |
Name of a CertificateProvider bean that supplies the trust material (trusted certificates) for the SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates; when not set, the legacy {@code trust-store} configuration is used instead. May be combined with {@code keyName} to also source the key material from a provider. |
|
java.lang.String |
Sets the protocol to use. Default value ("TLS"). |
|
java.time.Duration |
The timeout for the SSL handshake |
|
boolean |
Whether an OpenSSL-backed TLS implementation should be preferred if it’s on the classpath. {@code true} by default. |
|
boolean |
Sets whether to build a self-signed certificate. Default value (false). |
Property | Type | Description |
---|---|---|
|
int |
default maximum of decoded key value parameters. Default value {@link #DEFAULT_MAX_DECODED_KEY_VALUE_PARAMETERS}. |
|
boolean |
true if the semicolon is treated as a normal character, false otherwise |
Property | Type | Description |
---|---|---|
|
boolean |
Whether SSL is enabled. Default value (false). |
|
int |
Sets the SSL port. Default value (8443). |
|
Sets the client authentication mode. |
|
|
java.lang.String |
Sets the ciphers to use. |
|
java.lang.String |
Sets the protocols to use. |
|
java.lang.String |
Name of a CertificateProvider bean that supplies the trust material (trusted certificates) for the SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates; when not set, the legacy {@code trust-store} configuration is used instead. May be combined with {@code keyName} to also source the key material from a provider. |
|
java.lang.String |
Sets the protocol to use. Default value ("TLS"). |
|
java.time.Duration |
The timeout for the SSL handshake |
|
boolean |
Sets whether to build a self-signed certificate. Default value (false). |
|
boolean |
Whether an OpenSSL-backed TLS implementation should be preferred if it’s on the classpath. {@code true} by default. |
|
boolean |
Whether the client should disable checking of the remote SSL certificate. Only applies if no trust store is configured. <b>Note: This makes the SSL connection insecure, and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.</b> |
Property | Type | Description |
---|---|---|
|
java.lang.String |
The path to the trust store (typically .jks). Can also point to a PEM file containing one or more X.509 certificates. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. |
|
java.lang.String |
Sets the password to use for the keystore. |
|
java.lang.String |
Sets the type of keystore. |
|
java.lang.String |
Sets the keystore provider name. |
|
Sets the trust store configuration. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
Sets the password. |
|
java.lang.String |
Sets the alias. |
|
Sets the key configuration. |
|
|
java.lang.String |
Name of a CertificateProvider bean that supplies the private key and certificate chain for the SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates; when not set, the legacy {@code key}/{@code key-store} configuration is used instead. May be combined with {@code trustName} to also source the trust store from a provider. |
Property | Type | Description |
---|---|---|
|
java.util.List |
Default value (Empty list). |
Property | Type | Description |
---|---|---|
|
java.lang.String |
The path to the trust store (typically .jks). Can also point to a PEM file containing one or more X.509 certificates. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. |
|
java.lang.String |
Sets the password to use for the keystore. |
|
java.lang.String |
Sets the type of keystore. |
|
java.lang.String |
Sets the keystore provider name. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
The path to the trust store (typically .jks). Can also point to a PEM file containing one or more X.509 certificates. Can use {@code classpath:}, {@code file:}, {@code string:} or {@code base64:}. |
|
java.lang.String |
Sets the password to use for the keystore. |
|
java.lang.String |
Sets the type of keystore. |
|
java.lang.String |
Sets the keystore provider name. |
|
Sets the trust store configuration. |
Property | Type | Description |
---|---|---|
|
io.netty.pkitesting.CertificateBuilder$Algorithm |
Algorithm used to generate the self-signed key pair and certificate (e.g. RSA, EC). Controls the cryptographic parameters used by {@link io.netty.pkitesting.CertificateBuilder}. Defaults to {@code rsa4096}. |
|
java.lang.String |
X.500 subject distinguished name for the generated certificate, for example {@code CN=localhost}. This value is passed to the certificate builder and becomes the certificate’s subject. Defaults to {@code CN=localhost}. |
|
java.time.Duration |
Interval at which a new self-signed certificate is generated and emitted. Used to schedule periodic regeneration via a fixed-rate task so updated material is picked up automatically. Defaults to 1 day. |
|
java.time.Duration |
Validity period of the generated certificate. The certificate’s {@code notAfter} is set to now plus this duration when building the self-signed certificate. Defaults to 7 days. |
Property | Type | Description |
---|---|---|
|
Explicit format of the certificate material. If not set, Micronaut will first try to load the file as a key store (JKS/PKCS12) and, if that fails, as PEM. A separate {@code certificatePath} can only be used with PEM. |
|
|
java.lang.String |
Password used to open the key store (JKS/PKCS12) or decrypt PEM private keys, if required. |
|
java.nio.file.Path |
Path to the main certificate file to load. For JKS/PKCS12 this is a key store (optionally protected by {@code password}). For PEM this file may contain a private key and optionally certificates; when it only contains a private key, the certificate chain can be supplied via {@code certificatePath}. Reload behavior is controlled by {@code refreshMode}/{@code refreshInterval}. |
|
java.nio.file.Path |
Optional path to a separate PEM-encoded certificate chain. Only supported when the {@code format} is {@code PEM}. When set, the main file at {@code path} must contain only the private key. |
|
Strategy for reloading the certificate file. {@code NONE}: load once. {@code FILE_WATCHER}: watch the directory and reload on changes. {@code SCHEDULER}: periodically reload. {@code FILE_WATCHER_OR_SCHEDULER}: use a watcher when supported, otherwise fall back to scheduled reloads. |
|
|
java.time.Duration |
Interval used for scheduled reloads when the refresh mode uses a scheduler or when file watching is not available and a scheduled fallback is used. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
Sets the password. |
|
java.lang.String |
Sets the alias. |
|
Sets the key configuration. |
|
|
java.lang.String |
Name of a CertificateProvider bean that supplies the private key and certificate chain for the SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates; when not set, the legacy {@code key}/{@code key-store} configuration is used instead. May be combined with {@code trustName} to also source the trust store from a provider. |
Micronaut Http Netty Config Properties
🔗Property | Type | Description |
---|---|---|
|
io.netty.util.ResourceLeakDetector$Level |
Sets the resource leak detection level. |
|
boolean |
Default value: true. If {@code true}, netty event loop threads will implement project reactor {@link reactor.core.scheduler.NonBlocking} by default. Because of that, any Project Reactor’s blocking operations throw an exception on those threads. |
|
boolean |
Default value: false. |
|
int |
Default value: false. Minimum value: {@value Thread.MIN_PRIORITY}, maximum value: {@value Thread.MAX_PRIORITY} |
Property | Type | Description |
---|---|---|
|
int |
The number of threads |
|
double |
The number of threads per core to use if {@link #getNumThreads()} is set to 0. |
|
java.lang.Integer |
The IO ratio (optional) |
|
boolean |
Whether native transport is to be preferred |
|
java.util.List |
The transports to use for this event loop, in order of preference. Supported values are {@code io_uring,epoll,kqueue,nio}. The first available transport out of those listed will be used (nio is always available). If no listed transport is available, an exception will be thrown. <p>By default, only {@code nio} is used, even if native transports are available. If the legacy {@link #isPreferNativeTransport() prefer-native-transport} property is set to {@code true}, this defaults to {@code io_uring,epoll,kqueue,nio}. |
|
java.lang.String |
A named executor service to use for event loop threads (optional). This property is very specialized. In particular, it will <i>not</i> solve read timeouts or fix blocking operations on the event loop, in fact it may do the opposite. Don’t use unless you really know what this does. |
|
java.time.Duration |
The shutdown quiet period |
|
java.time.Duration |
The shutdown timeout (must be >= shutdownQuietPeriod) |
|
boolean |
When set to {@code true}, use a special <i>experimental</i> event loop that can also execute virtual threads, in order to improve virtual thread performance. |
Property | Type | Description |
---|---|---|
|
java.time.Duration |
Time slice size in latency mode. |
|
java.time.Duration |
Time slice size in throughput mode. |
|
java.time.Duration |
Number of nanoseconds between switching between continuation FILO and FIFO modes. |
|
java.time.Duration |
Oldest enqueued continuation must be this old before execution can switch to FIFO mode. |
|
java.time.Duration |
Maximum blocking wait time. |
|
int |
Maximum number of queued tasks before entering throughput mode. |
|
int |
Maximum number of threads per event loop before work spilling should kick in. |
|
int |
Number of tasks that should run on the normal FJP to initialize e.g. the Poller before switching to the netty scheduler |
Micronaut Http Server Config Properties
🔗Property | Type | Description |
---|---|---|
|
int |
Cache Seconds. Default value (60). |
Property | Type | Description |
---|---|---|
|
java.util.Locale |
Set the language tag for the locale. Supports BCP 47 language tags (e.g. "en-US") and ISO standard (e.g "en_US"). |
|
java.lang.String |
Sets the key in the session to look for the locale. |
|
java.util.Locale |
Sets the locale that will be used if the locale cannot be resolved through any means. Defaults to the system default. |
|
java.lang.String |
Sets the name of the cookie that is used to store the locale. |
|
boolean |
Set to true if the locale should be resolved from the |
Property | Type | Description |
---|---|---|
|
java.lang.String |
The host header name |
|
java.lang.String |
The protocol header name |
|
java.lang.String |
The port header name |
|
boolean |
If the host header supports a port |
|
java.util.List |
The list of hosts to validate the resolved host against. |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether CORS is enabled. Default value (false) |
|
boolean |
Sets whether localhost pass-through is enabled. Default value false. Setting this to true will allow requests to be made to localhost from any origin. |
|
java.util.Map |
Sets the CORS configurations. |
|
boolean |
Sets whether CORS header values should be joined into a single header. Default value (false). |
Property | Type | Description |
---|---|---|
|
Sets the HTTP version to use. Defaults to {@link HttpVersion#HTTP_1_1}. |
|
|
Sets the ThreadSelection model to use for the server. Default value MANUAL. |
|
|
java.nio.charset.Charset |
The default charset to use |
|
int |
Sets the port to bind to. Default value (-1) |
|
java.lang.String |
Sets the host to bind to. |
|
java.lang.Integer |
Sets the default read timeout. |
|
long |
Sets the maximum request size. Default value (1024 * 1024 * 10L => // 10MB) |
|
long |
Sets the maximum number of request bytes that will be buffered. Fully streamed requests can still exceed this value. Default value (1024 * 1024 * 10L => // 10MB). Currently limited to {@code 2^31}, if you need longer request bodies, stream them.<br> Note that there is always some internal buffering, so a very low value ({@code < ~64K}) will essentially act like a request size limit. |
|
java.time.Duration |
Sets the amount of time a connection can remain idle without any reads occurring. Default value (5L minutes). |
|
java.time.Duration |
Sets the amount of time a connection can remain idle without any writes occurring. Default value (5L minutes). |
|
java.time.Duration |
Sets the idle time of connections for the server. Default value (5 minutes). |
|
java.lang.String |
Sets the name of the server header. |
|
boolean |
Sets whether a date header should be sent back. Default value (true). |
|
boolean |
Sets whether exceptions handled by either an error route or exception handler should still be logged. Default value (false). |
|
java.lang.String |
Which header stores the original client |
|
java.lang.String |
Sets the context path for the web server. |
|
boolean |
if dual protocol has been enabled or not |
|
boolean |
if redirection from HTTP to HTTPS is enabled or not |
|
boolean |
Set to true to dispatch OPTIONS requests. Default value (false. |
|
boolean |
If the url should be validated by converting it to {@link java.net.URI}. |
|
boolean |
Browsers can send characters (such as {@code |
}) which are not permitted under RFC 3986 as part of the request path. These characters are normally rejected by the server. If this setting is enabled, the server will escape these characters before parsing them using {@link java.net.URI} so that they are not rejected. Default off. |
|
boolean |
True if not-found should be returned on missing body. False to return an empty body. |
|
boolean |
Sets whether the semicolon should be considered a normal character in the query. A "normal" semicolon is one that is not used as a parameter separator. |
|
int |
Property | Type | Description |
---|---|---|
|
java.io.File |
Sets the location to store files. |
|
long |
Sets the max file size. Default value (1024L * 1024 => 1MB). |
|
boolean |
Sets whether multipart processing is enabled. Default value (false). |
|
boolean |
Sets whether to buffer data to disk or not. Default value (false). |
|
boolean |
Sets whether to buffer data to disk if the size is greater than the threshold. Default value (false). |
|
long |
Sets the amount of data that should be received that will trigger the data to be stored to disk. Default value (1024L * 1024 * 10). |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether the cache control is public. Default value (false) |
Micronaut Http Server Netty Config Properties
🔗Property | Type | Description |
---|---|---|
|
boolean |
Enables or Disables the access logger. |
|
java.lang.String |
Sets the logger name to use. If not specified 'HTTP_ACCESS_LOGGER' will be used. |
|
java.lang.String |
Sets the log format to use. When not specified, the Common Log Format (CLF) will be used. |
|
java.util.List |
Sets the URI patterns to be excluded from the access log. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
Sets the name to use. |
|
int |
Sets the number of threads for the event loop group. |
|
java.lang.Integer |
Sets the I/O ratio. |
|
java.lang.String |
A named executor service to use for event loop threads (optional). This property is very specialized. In particular, it will <i>not</i> solve read timeouts or fix blocking operations on the event loop, in fact it may do the opposite. Don’t use unless you really know what this does. |
|
boolean |
Set whether to prefer the native transport if available |
|
java.time.Duration |
Set the shutdown quiet period |
|
java.time.Duration |
Set the shutdown timeout (must be >= shutdownQuietPeriod) |
|
double |
The number of threads per core to use if {@link #getNumThreads()} is set to 0. |
|
java.util.List |
The transports to use for this event loop, in order of preference. Supported values are {@code io_uring,epoll,kqueue,nio}. The first available transport out of those listed will be used (nio is always available). If no listed transport is available, an exception will be thrown. <p>By default, only {@code nio} is used, even if native transports are available. If the legacy {@link #isPreferNativeTransport() prefer-native-transport} property is set to {@code true}, this defaults to {@code io_uring,epoll,kqueue,nio}. |
|
boolean |
When set to {@code true}, use a special <i>experimental</i> event loop that can also execute virtual threads, in order to improve virtual thread performance. |
Property | Type | Description |
---|---|---|
|
java.lang.Long |
Sets the {@code SETTINGS_HEADER_TABLE_SIZE} value. |
|
java.lang.Boolean |
Does nothing. |
|
java.lang.Long |
Sets the {@code SETTINGS_MAX_CONCURRENT_STREAMS} value. |
|
java.lang.Integer |
Sets the {@code SETTINGS_INITIAL_WINDOW_SIZE} value. |
|
java.lang.Integer |
Sets the {@code SETTINGS_MAX_FRAME_SIZE} value. |
|
java.lang.Long |
Sets the {@code SETTINGS_MAX_HEADER_LIST_SIZE} value. |
Property | Type | Description |
---|---|---|
|
int |
Cache Seconds. Default value (60). |
Property | Type | Description |
---|---|---|
|
NettyHttpServerConfiguration$NettyListenerConfiguration$Family |
The address family of this listener. |
|
boolean |
Whether to enable SSL on this listener. Also requires ssl.SslConfiguration#isEnabled() to be set. |
|
java.lang.String |
Name of a CertificateProvider bean that supplies the private key and certificate chain for this listener’s SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates. If not set, the global SSL configuration (e.g. ssl.SslConfiguration#getKeyName()) or legacy keystore properties may be used instead. |
|
java.lang.String |
Name of a CertificateProvider bean that supplies the trust material (trusted certificates) for this listener’s SSL context. When set, Micronaut resolves the named provider and subscribes to its keystore updates. If not set, the global SSL configuration (e.g. ssl.SslConfiguration#getTrustName()) or legacy trust store properties may be used instead. |
|
java.lang.String |
For TCP listeners, the host to bind to, or {@code null} to bind to all hosts. |
|
int |
The TCP port to bind to. May be {@code -1} to bind to a random port. |
|
java.lang.String |
For UNIX domain sockets, the path of the socket. For abstract domain sockets, this should start with a NUL byte. |
|
boolean |
Whether to expose default routes on this listener. |
|
boolean |
If {@code true} (the default), this listener will stop accepting new connections and terminate any existing ones when a graceful shutdown is initiated. By setting this to {@code false} you can ignore the graceful shutdown, e.g. to keep a management port up while the shutdown of other listeners is in progress. |
|
java.lang.Integer |
The fixed file descriptor for this listener, or {@code null} if a new file descriptor should be opened (the default). |
|
boolean |
Whether the server should bind to the socket. {@code true} by default. If set to {@code false}, the socket must already be bound and listening. |
|
boolean |
Whether to create a server socket. This is on by default. Turning it off only makes sense in combination with {@link #acceptedFd}. |
|
java.lang.Integer |
An already accepted socket fd that should be registered to this listener. |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether the cache control is public. Default value (false) |
Property | Type | Description |
---|---|---|
|
int |
QUIC initial_max_data setting, see RFC 9000. |
|
int |
QUIC initial_max_stream_data_bidi_local setting, see RFC 9000. |
|
int |
QUIC initial_max_stream_data_bidi_remote setting, see RFC 9000. |
|
int |
QUIC initial_max_streams_bidi setting, see RFC 9000. |
Property | Type | Description |
---|---|---|
|
java.lang.String |
Sets the name to use. |
|
int |
Sets the number of threads for the event loop group. |
|
java.lang.Integer |
Sets the I/O ratio. |
|
java.lang.String |
A named executor service to use for event loop threads (optional). This property is very specialized. In particular, it will <i>not</i> solve read timeouts or fix blocking operations on the event loop, in fact it may do the opposite. Don’t use unless you really know what this does. |
|
boolean |
Set whether to prefer the native transport if available |
|
java.time.Duration |
Set the shutdown quiet period |
|
java.time.Duration |
Set the shutdown timeout (must be >= shutdownQuietPeriod) |
|
double |
The number of threads per core to use if {@link #getNumThreads()} is set to 0. |
|
java.util.List |
The transports to use for this event loop, in order of preference. Supported values are {@code io_uring,epoll,kqueue,nio}. The first available transport out of those listed will be used (nio is always available). If no listed transport is available, an exception will be thrown. <p>By default, only {@code nio} is used, even if native transports are available. If the legacy {@link #isPreferNativeTransport() prefer-native-transport} property is set to {@code true}, this defaults to {@code io_uring,epoll,kqueue,nio}. |
|
boolean |
When set to {@code true}, use a special <i>experimental</i> event loop that can also execute virtual threads, in order to improve virtual thread performance. |
Property | Type | Description |
---|---|---|
|
Set the server type. |
|
|
boolean |
If a 100-continue response is detected but the content length is too large then true means close the connection. otherwise the connection will remain open and data will be consumed and discarded until the next request is received. <p>only relevant when {@link HttpServerType#FULL_CONTENT} is set</p> |
|
java.lang.String |
Sets the fallback protocol to use when negotiating via ALPN. |
|
io.netty.handler.logging.LogLevel |
Sets the Netty log level. |
|
int |
Sets the maximum initial line length for the HTTP request. Default value (4096). |
|
int |
Sets the maximum size of any one header. Default value (8192). |
|
int |
Sets the maximum size of any single request chunk. Default value (8192). |
|
int |
Sets the maximum size of the body of the HTTP1.1 request used to upgrade a connection to HTTP2 clear-text (h2c). This initial request cannot be streamed and is instead buffered in full, so the default value (8192) is relatively small. <i>If this value is too small for your use case, instead consider using an empty initial "upgrade request" (e.g. {@code OPTIONS /}), or switch to normal HTTP2.</i> <p> <i>Does not affect normal HTTP2 (TLS).</i> |
|
boolean |
Sets whether chunked transfer encoding is supported. Default value (true). |
|
boolean |
Sets whether to use netty’s native transport (epoll or kqueue) if available . Default value (false). |
|
boolean |
Sets whether to validate incoming headers. Default value (true). |
|
int |
Sets the initial buffer size. Default value (128). |
|
int |
Sets the minimum size of a request body must be in order to be compressed. Default value (1024). |
|
int |
Sets the compression level (0-9). Default value (6). |
|
int |
Sets the maximum size of data that can be encoded using the zstd algorithm. Default value (1024 * 1024 * 32). |
|
java.util.Map |
Sets the Netty child worker options. |
|
java.util.Map |
Sets the channel options. |
|
boolean |
Whether to send connection keep alive on internal server errors. Default value ({@value DEFAULT_KEEP_ALIVE_ON_SERVER_ERROR}). |
|
java.lang.String |
The path pattern to use for logging incoming connections to pcap. This is an unsupported option: Behavior may change, or it may disappear entirely, without notice! |
|
java.util.List |
Set the explicit netty listener configurations, or {@code null} if they should be implicit. |
|
boolean |
Parse incoming JSON data eagerly, before route binding. Default value {@value DEFAULT_EAGER_PARSING}. |
|
int |
Maximum number of buffers to keep around in JSON parsing before they should be consolidated. Defaults to 4096. |
|
boolean |
Enable or disable automatic request content decompression in the Netty HTTP server. Disabling this can be useful for proxy or testing scenarios where the compressed payload and Content-Encoding header need to be observed. |
|
boolean |
Prior to 4.4.0, the Micronaut HTTP server used a multi-pipeline approach for handling HTTP/2 connections where every request got its own netty pipeline with HTTP/2 to HTTP/1.1 converters on the pipeline. This allowed for using mostly unchanged HTTP/1.1 in the request handling and any NettyServerCustomizers. <p> As of 4.4.0, this approach was replaced with a more performant HTTP/2-specific implementation. This means worse compatibility with HTTP/1.1-based code paths and customizers, however. Setting this option to {@code true} returns to the old behavior. |
|
int |
The maximum number of form fields permitted in a request. |
|
int |
The maximum number of bytes the form / multipart decoders are allowed to buffer internally. This sets a limit on form field size. |
Micronaut Jackson Databind Config Properties
🔗Property | Type | Description |
---|---|---|
|
boolean |
Whether the BeanIntrospection should be used for reflection free object serialialization/deserialialization. |
|
boolean |
Sets whether to scan for modules or not (defaults to true). |
|
com.fasterxml.jackson.annotation.JsonInclude$Include |
Sets the serialization inclusion mode. |
|
com.fasterxml.jackson.databind.ObjectMapper$DefaultTyping |
Sets the global defaultTyping using for Polymorphic handling. |
|
java.util.Locale |
Sets the locale to use. |
|
java.util.TimeZone |
Sets the timezone to use. |
|
java.lang.String |
Sets the default date format to use. |
|
int |
Sets the array size threshold for data binding. Default value (100). |
|
com.fasterxml.jackson.databind.PropertyNamingStrategy |
Sets the property naming strategy. |
|
boolean |
Sets whether _embedded.errors should always be serialized as list (defaults to false). If set to false, _embedded.errors with 1 element will be serialized as an object. |
|
boolean |
Whether strings should be trimmed when deserializing (defaults to false). If the resulting string is an empty string, then null will be applied instead. |
|
java.util.Map |
Sets the serialization features to use. |
|
java.util.Map |
Sets the deserialization features to use. |
|
java.util.Map |
Sets the object mapper features to use. |
|
java.util.Map |
Sets the parser features to use. |
|
java.util.Map |
Sets the generator features to use. |
|
java.util.Map |
Sets the factory features to use. |
Micronaut Management Config Properties
🔗Property | Type | Description |
---|---|---|
|
java.lang.String |
The endpoints base path. It must include a leading and trailing '/'. Default value ("/"). |
|
java.lang.String |
The endpoints context path. Default value is null. |
|
java.lang.Boolean |
Sets whether the endpoint is enabled. |
|
java.lang.Boolean |
Sets whether the endpoint is sensitive. |
|
java.lang.Integer |
Sets the port to expose endpoints via. |
Property | Type | Description |
---|---|---|
|
boolean |
If health indicator should be enabled. Default is true. |
Property | Type | Description |
---|---|---|
|
java.util.List |
Sets the sections to be displayed by the environment endpoint. Example: {@code endpoints.env.active-keys=activeEnvironments,packages} |
Property | Type | Description |
---|---|---|
|
boolean |
Determines whether modifications to the log level should require authentication. Default value (true). |
Property | Type | Description |
---|---|---|
|
java.util.Map |
Set how {@link HealthStatus} map to HttpStatus codes. |
Property | Type | Description |
---|---|---|
|
java.lang.Boolean |
Sets whether the endpoint is enabled. |
|
java.lang.Boolean |
Sets whether the endpoint is sensitive. |
|
java.lang.String |
Endpoint’s path. If not set the endpoint name is used as the path. |
Property | Type | Description |
---|---|---|
|
boolean |
Default value (true). |
|
java.io.File |
Default value ("."). |
|
long |
Default value (1024L * 1024 * 10 => 10MB). |
Property | Type | Description |
---|---|---|
|
boolean |
Set whether the ServiceReadyHealthIndicator is enabled. Defaults to {@code true}. |
|
Sets the visibility policy for health information. |
Micronaut Router Config Properties
🔗Property | Type | Description |
---|---|---|
|
boolean |
{@code true} if version based matches filtering is enabled. |
|
java.lang.String |
Sets the version to use if the version cannot be resolved. Default value (null). |
Property | Type | Description |
---|---|---|
|
java.util.List |
Sets which parameter should be searched for a version. |
|
boolean |
Sets whether parameter should be searched for a version. |
Property | Type | Description |
---|---|---|
|
boolean |
Sets whether this specific mapping is enabled. Default value (true). |
|
java.lang.String |
The path resources should be served from. Uses ant path matching. Default value ("/**"). |
|
java.util.List |
A list of paths either starting with |
Property | Type | Description |
---|---|---|
|
java.util.List |
Sets which headers should be searched for a version. |
|
boolean |
Sets whether headers should be searched for a version. |