Micronaut Core Configuration Reference

Every documented configuration property of Micronaut Core, with types, descriptions, and defaults.

338 properties across 13 sections

Buffer Netty Config Properties

Configuration properties for DefaultByteBufAllocatorConfiguration

Property	Type	Description
`netty.default.allocator.num-heap-arenas`	java.lang.Integer	The number of heap arenas
`netty.default.allocator.num-direct-arenas`	java.lang.Integer	The number of direct arenas
`netty.default.allocator.page-size`	java.lang.Integer	The page size
`netty.default.allocator.max-order`	java.lang.Integer	The max order
`netty.default.allocator.chunk-size`	java.lang.Integer	The chunk size
`netty.default.allocator.small-cache-size`	java.lang.Integer	The small cache size
`netty.default.allocator.normal-cache-size`	java.lang.Integer	The normal cache size
`netty.default.allocator.use-cache-for-all-threads`	java.lang.Boolean	Whether to use the cache for all threads
`netty.default.allocator.max-cached-buffer-capacity`	java.lang.Integer	The max cached buffer capacity
`netty.default.allocator.cache-trim-interval`	java.lang.Integer	The cache trim interval
`netty.default.allocator.max-cached-byte-buffers-per-chunk`	java.lang.Integer	The max cached byte buffers per chunk

Context Config Properties

Configuration properties for InstanceConfiguration

Property	Type	Description
`micronaut.application.instance`	ApplicationConfiguration$InstanceConfiguration	The instance configuration
`micronaut.application.instance.id`	java.lang.String	The instance identifier
`micronaut.application.instance.group`	java.lang.String	The instance auto scaling group
`micronaut.application.instance.zone`	java.lang.String	The instance availability zone
`micronaut.application.instance.metadata`	java.util.Map	The metadata to associate with the instance

Configuration properties for FileWatchConfiguration

Property	Type	Description
`micronaut.io.watch.enabled`	boolean	Whether watch is enabled.
`micronaut.io.watch.restart`	boolean	Set whether restart is enabled.
`micronaut.io.watch.paths`	java.util.List	Sets the watch paths to use.
`micronaut.io.watch.check-interval`	java.time.Duration	Sets the interval to wait between file watch polls.

Configuration properties for ApplicationConfiguration

Property	Type	Description
`micronaut.application.default-charset`	java.nio.charset.Charset	Default value (UTF-8).
`micronaut.application.name`	java.lang.String	Set the application name

Configuration properties for UserExecutorConfiguration

Property	Type	Description
`micronaut.executors.*.n-threads`	java.lang.Integer
`micronaut.executors.*.type`	ExecutorType
`micronaut.executors.*.parallelism`	java.lang.Integer
`micronaut.executors.*.core-pool-size`	java.lang.Integer
`micronaut.executors.*.thread-factory-class`	java.lang.Class
`micronaut.executors.*.name`	java.lang.String	Sets the executor name.
`micronaut.executors.*.number-of-threads`	java.lang.Integer	Sets the number of threads for FIXED . Default value (2 * Number of processors available to the Java virtual machine).

Http Client Core Config Properties

Configuration properties for DefaultKeyStoreConfiguration

Property	Type	Description
`micronaut.http.services.*.ssl.key-store`	SslConfiguration$KeyStoreConfiguration
`micronaut.http.services.*.ssl.key-store.path`	java.lang.String
`micronaut.http.services.*.ssl.key-store.password`	java.lang.String
`micronaut.http.services.*.ssl.key-store.type`	java.lang.String
`micronaut.http.services.*.ssl.key-store.provider`	java.lang.String

Configuration properties for DefaultConnectionPoolConfiguration

Property	Type	Description
`micronaut.http.client.pool.enabled`	boolean	Sets whether connection pooling is enabled. Default value (false).
`micronaut.http.client.pool.max-connections`	int	Sets the maximum number of connections. Defaults to no maximum.
`micronaut.http.client.pool.max-pending-acquires`	int	Sets the max pending acquires.
`micronaut.http.client.pool.acquire-timeout`	java.time.Duration	Sets the timeout to wait for a connection.

Configuration properties for DefaultClientVersioningConfiguration

Property	Type	Description
`micronaut.http.client.versioning.default.headers`	java.util.List	The list of request header names.
`micronaut.http.client.versioning.default.parameters`	java.util.List	The list of request query parameter names.

Configuration properties for DefaultHttpClientConfiguration

Property	Type	Description
`micronaut.http.client.http-version`	HttpVersion	Sets the HTTP version to use. Defaults to {@link HttpVersion#HTTP_1_1}.
`micronaut.http.client.log-level`	LogLevel	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.
`micronaut.http.client.event-loop-group`	java.lang.String	Sets the event loop group to use for the client.
`micronaut.http.client.ssl-configuration`	SslConfiguration	Sets the SSL configuration for the client.
`micronaut.http.client.exception-on-error-status`	boolean	Sets whether throwing an exception upon HTTP error status (>= 400) is preferred. Default value ( DEFAULT_EXCEPTION_ON_ERROR_STATUS )
`micronaut.http.client.logger-name`	java.lang.String	Sets the client-specific logger name.
`micronaut.http.client.follow-redirects`	boolean	Sets whether redirects should be followed. Default value ( DEFAULT_FOLLOW_REDIRECTS ).
`micronaut.http.client.default-charset`	java.nio.charset.Charset	Sets the default charset to use. Default value (UTF-8);
`micronaut.http.client.channel-options`	java.util.Map	The Client channel options
`micronaut.http.client.shutdown-quiet-period`	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.
`micronaut.http.client.shutdown-timeout`	java.time.Duration	Sets the amount of time to wait for shutdown of client thread pools. Default value (100 milliseconds).
`micronaut.http.client.read-timeout`	java.time.Duration	Sets the read timeout. Default value (10 seconds).
`micronaut.http.client.read-idle-timeout`	java.time.Duration	Sets the max read idle time for streaming requests. Default value (5 minutes).
`micronaut.http.client.connection-pool-idle-timeout`	java.time.Duration	Sets the idle timeout for connection in the client connection pool. Defaults to 0.
`micronaut.http.client.connect-timeout`	java.time.Duration	Sets the connect timeout.
`micronaut.http.client.connect-ttl`	java.time.Duration	Sets the connect timeout.
`micronaut.http.client.num-of-threads`	java.lang.Integer	Sets the number of threads the client should use for requests.
`micronaut.http.client.thread-factory`	java.lang.Class	Sets a thread factory.
`micronaut.http.client.max-content-length`	int	Sets the maximum content length the client can consume. Default value (1024 * 1024 * 10 ⇒ 10MB).
`micronaut.http.client.proxy-type`	java.net.Proxy$Type	The proxy type
`micronaut.http.client.proxy-address`	java.net.SocketAddress	Sets a proxy address.
`micronaut.http.client.proxy-username`	java.lang.String	Sets the proxy user name to use.
`micronaut.http.client.proxy-password`	java.lang.String	Sets the proxy password.
`micronaut.http.client.proxy-selector`	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)}.

Configuration properties for ServiceHttpClientConfiguration

Property	Type	Description
`micronaut.http.services.*.http-version`	HttpVersion	Sets the HTTP version to use. Defaults to {@link HttpVersion#HTTP_1_1}.
`micronaut.http.services.*.log-level`	LogLevel	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.
`micronaut.http.services.*.event-loop-group`	java.lang.String	Sets the event loop group to use for the client.
`micronaut.http.services.*.exception-on-error-status`	boolean	Sets whether throwing an exception upon HTTP error status (>= 400) is preferred. Default value ( DEFAULT_EXCEPTION_ON_ERROR_STATUS )
`micronaut.http.services.*.logger-name`	java.lang.String	Sets the client-specific logger name.
`micronaut.http.services.*.follow-redirects`	boolean	Sets whether redirects should be followed. Default value ( DEFAULT_FOLLOW_REDIRECTS ).
`micronaut.http.services.*.default-charset`	java.nio.charset.Charset	Sets the default charset to use. Default value (UTF-8);
`micronaut.http.services.*.channel-options`	java.util.Map	The Client channel options
`micronaut.http.services.*.shutdown-quiet-period`	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.
`micronaut.http.services.*.shutdown-timeout`	java.time.Duration	Sets the amount of time to wait for shutdown of client thread pools. Default value (100 milliseconds).
`micronaut.http.services.*.read-timeout`	java.time.Duration	Sets the read timeout. Default value (10 seconds).
`micronaut.http.services.*.read-idle-timeout`	java.time.Duration	Sets the max read idle time for streaming requests. Default value (5 minutes).
`micronaut.http.services.*.connection-pool-idle-timeout`	java.time.Duration	Sets the idle timeout for connection in the client connection pool. Defaults to 0.
`micronaut.http.services.*.connect-timeout`	java.time.Duration	Sets the connect timeout.
`micronaut.http.services.*.connect-ttl`	java.time.Duration	Sets the connect timeout.
`micronaut.http.services.*.num-of-threads`	java.lang.Integer	Sets the number of threads the client should use for requests.
`micronaut.http.services.*.thread-factory`	java.lang.Class	Sets a thread factory.
`micronaut.http.services.*.max-content-length`	int	Sets the maximum content length the client can consume. Default value (1024 * 1024 * 10 ⇒ 10MB).
`micronaut.http.services.*.proxy-type`	java.net.Proxy$Type	The proxy type
`micronaut.http.services.*.proxy-address`	java.net.SocketAddress	Sets a proxy address.
`micronaut.http.services.*.proxy-username`	java.lang.String	Sets the proxy user name to use.
`micronaut.http.services.*.proxy-password`	java.lang.String	Sets the proxy password.
`micronaut.http.services.*.proxy-selector`	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)}.
`micronaut.http.services.*.urls`	java.util.List	Sets the URIs of the service.
`micronaut.http.services.*.health-check-uri`	java.lang.String	Sets the health check URI. Default value ("/health").
`micronaut.http.services.*.health-check`	boolean	Sets whether the service health should be checked. Default value (false).
`micronaut.http.services.*.health-check-interval`	java.time.Duration	Sets the default duration to check health status. Default value (30 seconds).
`micronaut.http.services.*.path`	java.lang.String	Sets the context path to use for requests.
`micronaut.http.services.*.url`	java.net.URI	Sets the URL of the service.

Configuration properties for DefaultTrustStoreConfiguration

Property	Type	Description
`micronaut.http.services.*.ssl.trust-store`	SslConfiguration$TrustStoreConfiguration
`micronaut.http.services.*.ssl.trust-store.path`	java.lang.String
`micronaut.http.services.*.ssl.trust-store.password`	java.lang.String
`micronaut.http.services.*.ssl.trust-store.type`	java.lang.String
`micronaut.http.services.*.ssl.trust-store.provider`	java.lang.String

Configuration properties for ServiceConnectionPoolConfiguration

Property	Type	Description
`micronaut.http.services.*.pool.enabled`	boolean	Sets whether connection pooling is enabled. Default value (false).
`micronaut.http.services.*.pool.max-connections`	int	Sets the maximum number of connections. Defaults to no maximum.
`micronaut.http.services.*.pool.max-pending-acquires`	int	Sets the max pending acquires.
`micronaut.http.services.*.pool.acquire-timeout`	java.time.Duration	Sets the timeout to wait for a connection.

Configuration properties for NamedClientVersioningConfiguration

Property	Type	Description
`micronaut.http.client.versioning.*.headers`	java.util.List	The list of request header names.
`micronaut.http.client.versioning.*.parameters`	java.util.List	The list of request query parameter names.

Configuration properties for DefaultKeyConfiguration

Property	Type	Description
`micronaut.http.services.*.ssl.key`	SslConfiguration$KeyConfiguration
`micronaut.http.services.*.ssl.key.password`	java.lang.String
`micronaut.http.services.*.ssl.key.alias`	java.lang.String

Configuration properties for ServiceSslClientConfiguration

Property	Type	Description
`micronaut.http.services.*.ssl-configuration`	SslConfiguration	Sets the SSL configuration for the client.
`micronaut.http.services.*.ssl.port`	int
`micronaut.http.services.*.ssl.build-self-signed`	boolean
`micronaut.http.services.*.ssl.enabled`	boolean
`micronaut.http.services.*.ssl.client-authentication`	ClientAuthentication
`micronaut.http.services.*.ssl.ciphers`	java.lang.String
`micronaut.http.services.*.ssl.protocols`	java.lang.String
`micronaut.http.services.*.ssl.protocol`	java.lang.String
`micronaut.http.services.*.ssl.handshake-timeout`	java.time.Duration
`micronaut.http.services.*.ssl.insecure-trust-all-certificates`	boolean

Http Config Properties

Configuration properties for DefaultKeyStoreConfiguration

Property	Type	Description
`micronaut.server.ssl.key-store`	SslConfiguration$KeyStoreConfiguration	Sets the keystore configuration.
`micronaut.server.ssl.key-store.path`	java.lang.String	Sets the path.
`micronaut.server.ssl.key-store.password`	java.lang.String	Sets the password to use for the keystore.
`micronaut.server.ssl.key-store.type`	java.lang.String	Sets the type of keystore.
`micronaut.server.ssl.key-store.provider`	java.lang.String	Sets the keystore provider name.

Configuration properties for DefaultSslConfiguration

Property	Type	Description
`micronaut.ssl.port`	int	Sets the SSL port. Default value (8443).
`micronaut.ssl.build-self-signed`	boolean	Sets whether to build a self signed certificate. Default value (false).
`micronaut.ssl.enabled`	boolean	Whether SSL is enabled. Default value (false).
`micronaut.ssl.client-authentication`	ClientAuthentication	Sets the client authentication mode.
`micronaut.ssl.ciphers`	java.lang.String	Sets the ciphers to use.
`micronaut.ssl.protocols`	java.lang.String	Sets the protocols to use.
`micronaut.ssl.protocol`	java.lang.String	Sets the protocol to use. Default value ("TLS").
`micronaut.ssl.handshake-timeout`	java.time.Duration	The timeout for the SSL handshake

Configuration properties for DefaultKeyConfiguration

Property	Type	Description
`micronaut.ssl.key`	SslConfiguration$KeyConfiguration	Sets the key configuration.
`micronaut.ssl.key.password`	java.lang.String	Sets the password.
`micronaut.ssl.key.alias`	java.lang.String	Sets the alias.

Configuration properties for DefaultTrustStoreConfiguration

Property	Type	Description
`micronaut.http.client.ssl.trust-store`	SslConfiguration$TrustStoreConfiguration	Sets the trust store configuration.
`micronaut.http.client.ssl.trust-store.path`	java.lang.String	Sets the path.
`micronaut.http.client.ssl.trust-store.password`	java.lang.String	Sets the password to use for the keystore.
`micronaut.http.client.ssl.trust-store.type`	java.lang.String	Sets the type of keystore.
`micronaut.http.client.ssl.trust-store.provider`	java.lang.String	Sets the keystore provider name.

Configuration properties for ServerSslConfiguration

Property	Type	Description
`micronaut.server.ssl.port`	int	Sets the SSL port. Default value (8443).
`micronaut.server.ssl.build-self-signed`	boolean	Sets whether to build a self signed certificate. Default value (false).
`micronaut.server.ssl.enabled`	boolean	Whether SSL is enabled. Default value (false).
`micronaut.server.ssl.client-authentication`	ClientAuthentication	Sets the client authentication mode.
`micronaut.server.ssl.ciphers`	java.lang.String	Sets the ciphers to use.
`micronaut.server.ssl.protocols`	java.lang.String	Sets the protocols to use.
`micronaut.server.ssl.protocol`	java.lang.String	Sets the protocol to use. Default value ("TLS").
`micronaut.server.ssl.handshake-timeout`	java.time.Duration	The timeout for the SSL handshake

Configuration properties for DefaultKeyStoreConfiguration

Property	Type	Description
`micronaut.http.client.ssl.key-store`	SslConfiguration$KeyStoreConfiguration	Sets the keystore configuration.
`micronaut.http.client.ssl.key-store.path`	java.lang.String	Sets the path.
`micronaut.http.client.ssl.key-store.password`	java.lang.String	Sets the password to use for the keystore.
`micronaut.http.client.ssl.key-store.type`	java.lang.String	Sets the type of keystore.
`micronaut.http.client.ssl.key-store.provider`	java.lang.String	Sets the keystore provider name.

Configuration properties for DefaultTrustStoreConfiguration

Property	Type	Description
`micronaut.ssl.trust-store`	SslConfiguration$TrustStoreConfiguration	Sets the trust store configuration.
`micronaut.ssl.trust-store.path`	java.lang.String	Sets the path.
`micronaut.ssl.trust-store.password`	java.lang.String	Sets the password to use for the keystore.
`micronaut.ssl.trust-store.type`	java.lang.String	Sets the type of keystore.
`micronaut.ssl.trust-store.provider`	java.lang.String	Sets the keystore provider name.

Configuration properties for DefaultKeyStoreConfiguration

Property	Type	Description
`micronaut.ssl.key-store`	SslConfiguration$KeyStoreConfiguration	Sets the keystore configuration.
`micronaut.ssl.key-store.path`	java.lang.String	Sets the path.
`micronaut.ssl.key-store.password`	java.lang.String	Sets the password to use for the keystore.
`micronaut.ssl.key-store.type`	java.lang.String	Sets the type of keystore.
`micronaut.ssl.key-store.provider`	java.lang.String	Sets the keystore provider name.

Configuration properties for DefaultKeyConfiguration

Property	Type	Description
`micronaut.server.ssl.key`	SslConfiguration$KeyConfiguration	Sets the key configuration.
`micronaut.server.ssl.key.password`	java.lang.String	Sets the password.
`micronaut.server.ssl.key.alias`	java.lang.String	Sets the alias.

Configuration properties for ClientSslConfiguration

Property	Type	Description
`micronaut.http.client.ssl.port`	int	Sets the SSL port. Default value (8443).
`micronaut.http.client.ssl.build-self-signed`	boolean	Sets whether to build a self signed certificate. Default value (false).
`micronaut.http.client.ssl.enabled`	boolean	Whether SSL is enabled. Default value (false).
`micronaut.http.client.ssl.client-authentication`	ClientAuthentication	Sets the client authentication mode.
`micronaut.http.client.ssl.ciphers`	java.lang.String	Sets the ciphers to use.
`micronaut.http.client.ssl.protocols`	java.lang.String	Sets the protocols to use.
`micronaut.http.client.ssl.protocol`	java.lang.String	Sets the protocol to use. Default value ("TLS").
`micronaut.http.client.ssl.handshake-timeout`	java.time.Duration	The timeout for the SSL handshake
`micronaut.http.client.ssl.insecure-trust-all-certificates`	boolean	Whether the client should disable checking of the remote SSL certificate.

Configuration properties for DefaultKeyConfiguration

Property	Type	Description
`micronaut.http.client.ssl.key`	SslConfiguration$KeyConfiguration	Sets the key configuration.
`micronaut.http.client.ssl.key.password`	java.lang.String	Sets the password.
`micronaut.http.client.ssl.key.alias`	java.lang.String	Sets the alias.

Configuration properties for DefaultTrustStoreConfiguration

Property	Type	Description
`micronaut.server.ssl.trust-store`	SslConfiguration$TrustStoreConfiguration	Sets the trust store configuration.
`micronaut.server.ssl.trust-store.path`	java.lang.String	Sets the path.
`micronaut.server.ssl.trust-store.password`	java.lang.String	Sets the password to use for the keystore.
`micronaut.server.ssl.trust-store.type`	java.lang.String	Sets the type of keystore.
`micronaut.server.ssl.trust-store.provider`	java.lang.String	Sets the keystore provider name.

Configuration properties for CodecConfiguration

Property	Type	Description
`micronaut.codec.*.additional-types`	java.util.List	Default value (Empty list).

Http Netty Config Properties

Configuration properties for DefaultEventLoopGroupConfiguration

Property	Type	Description
`micronaut.netty.event-loops.*.num-threads`	int
`micronaut.netty.event-loops.*.io-ratio`	java.lang.Integer
`micronaut.netty.event-loops.*.prefer-native-transport`	boolean
`micronaut.netty.event-loops.*.executor`	java.lang.String
`micronaut.netty.event-loops.*.shutdown-quiet-period`	java.time.Duration
`micronaut.netty.event-loops.*.shutdown-timeout`	java.time.Duration

Configuration properties for NettyGlobalConfiguration

Property	Type	Description
`netty.resource-leak-detector-level`	io.netty.util.ResourceLeakDetector$Level	Sets the resource leak detection level.

Http Server Config Properties

Configuration properties for HttpServerConfiguration

Property	Type	Description
`micronaut.server.port`	java.lang.Integer	Sets the port to bind to. Default value (-1)
`micronaut.server.host`	java.lang.String	Sets the host to bind to.
`micronaut.server.read-timeout`	java.lang.Integer	Sets the default read timeout.
`micronaut.server.max-request-size`	long	Sets the maximum request size. Default value (1024 * 1024 * 10L ⇒ // 10MB)
`micronaut.server.read-idle-timeout`	java.time.Duration	Sets the amount of time a connection can remain idle without any reads occurring. Default value (5L minutes).
`micronaut.server.write-idle-timeout`	java.time.Duration	Sets the amount of time a connection can remain idle without any writes occurring. Default value (5L minutes).
`micronaut.server.idle-timeout`	java.time.Duration	Sets the idle time of connections for the server. Default value (5 minutes).
`micronaut.server.server-header`	java.lang.String	Sets the name of the server header.
`micronaut.server.date-header`	boolean	Sets whether a date header should be sent back. Default value (true).
`micronaut.server.log-handled-exceptions`	boolean	Sets whether exceptions handled by either an error route or exception handler should still be logged. Default value (false).
`micronaut.server.client-address-header`	java.lang.String	The header that stores the original client address
`micronaut.server.context-path`	java.lang.String	Sets the context path for the web server.
`micronaut.server.dual-protocol`	boolean	the dual protocol (http/https) configuration. Default value (false).
`micronaut.server.http-to-https-redirect`	boolean	Set to true to enable redirecting all http requests to the same URL but with
`micronaut.server.http-version`	HttpVersion	Sets the HTTP version to use. Defaults to {@link HttpVersion#HTTP_1_1}.
`micronaut.server.default-charset`	java.nio.charset.Charset	The default charset to use
`micronaut.server.thread-selection`	ThreadSelection	Sets the {@link ThreadSelection} model to use for the server.

Configuration properties for HostResolutionConfiguration

Property	Type	Description
`micronaut.server.host-resolution`	HttpServerConfiguration$HostResolutionConfiguration	The host resolution configuration
`micronaut.server.host-resolution.host-header`	java.lang.String	The header name that stores the host
`micronaut.server.host-resolution.protocol-header`	java.lang.String	The header name that stores the protocol
`micronaut.server.host-resolution.port-header`	java.lang.String	The header name that stores the port
`micronaut.server.host-resolution.port-in-host`	boolean	True if the host header supports a port
`micronaut.server.host-resolution.allowed-hosts`	java.util.List	The list of allowed host regex patterns. Any resolved

Configuration properties for CorsConfiguration

Property	Type	Description
`micronaut.server.cors`	HttpServerConfiguration$CorsConfiguration	Sets the cors configuration.
`micronaut.server.cors.enabled`	boolean	Sets whether CORS is enabled. Default value (false)
`micronaut.server.cors.single-header`	boolean	Sets whether CORS header values should be joined into a single header. Default value (false).
`micronaut.server.cors.configurations`	java.util.Map	Sets the CORS configurations.

Configuration properties for HttpLocaleResolutionConfigurationProperties

Property	Type	Description
`micronaut.server.locale-resolution`	HttpServerConfiguration$HttpLocaleResolutionConfigurationProperties	The locale resolution configuration
`micronaut.server.locale-resolution.fixed`	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").
`micronaut.server.locale-resolution.session-attribute`	java.lang.String	Sets the key in the session to look for the locale.
`micronaut.server.locale-resolution.cookie-name`	java.lang.String	Sets the name of the cookie that is used to store the locale.
`micronaut.server.locale-resolution.header`	boolean	Set to true if the locale should be resolved from the Accept-Language header. Default value (true).
`micronaut.server.locale-resolution.default-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.

Configuration properties for MultipartConfiguration

Property	Type	Description
`micronaut.server.multipart.location`	java.io.File	Sets the location to store files.
`micronaut.server.multipart.max-file-size`	long	Sets the max file size. Default value (1024L * 1024 ⇒ 1MB).
`micronaut.server.multipart.enabled`	java.lang.Boolean	Sets whether multipart processing is enabled. Default value (false).
`micronaut.server.multipart.disk`	boolean	Sets whether to buffer data to disk or not. Default value (false).
`micronaut.server.multipart.mixed`	boolean	Sets whether to buffer data to disk if the size is greater than the threshold. Default value (false).
`micronaut.server.multipart.threshold`	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).
`micronaut.server.multipart`	HttpServerConfiguration$MultipartConfiguration	Sets the multipart configuration.

Http Server Netty Config Properties

Configuration properties for Http2Settings

Property	Type	Description
`micronaut.server.netty.http2`	NettyHttpServerConfiguration$Http2Settings	Sets the Http2Settings.
`micronaut.server.netty.http2.header-table-size`	java.lang.Long	Sets the {@code SETTINGS_HEADER_TABLE_SIZE} value.
`micronaut.server.netty.http2.push-enabled`	java.lang.Boolean	Sets the {@code SETTINGS_ENABLE_PUSH} value.
`micronaut.server.netty.http2.max-concurrent-streams`	java.lang.Long	Sets the {@code SETTINGS_MAX_CONCURRENT_STREAMS} value.
`micronaut.server.netty.http2.initial-window-size`	java.lang.Integer	Sets the {@code SETTINGS_INITIAL_WINDOW_SIZE} value.
`micronaut.server.netty.http2.max-frame-size`	java.lang.Integer	Sets the {@code SETTINGS_MAX_FRAME_SIZE} value.
`micronaut.server.netty.http2.max-header-list-size`	java.lang.Long	Sets the {@code SETTINGS_MAX_HEADER_LIST_SIZE} value.

Configuration properties for AccessLogger

Property	Type	Description
`micronaut.server.netty.access-logger`	NettyHttpServerConfiguration$AccessLogger	Sets the AccessLogger configuration.
`micronaut.server.netty.access-logger.enabled`	boolean	Enables or Disables the access logger.
`micronaut.server.netty.access-logger.logger-name`	java.lang.String	Sets the logger name to use. If not specified 'HTTP_ACCESS_LOGGER' will be used.
`micronaut.server.netty.access-logger.log-format`	java.lang.String	Sets the log format to use. When not specified, the Common Log Format (CLF) will be used.
`micronaut.server.netty.access-logger.exclusions`	java.util.List	Sets the URI patterns to be excluded from the access log.

Configuration properties for Worker

Property	Type	Description
`micronaut.server.netty.worker`	NettyHttpServerConfiguration$Worker	Sets the worker event loop configuration.
`micronaut.server.netty.worker.event-loop-group`	java.lang.String	Sets the name to use.
`micronaut.server.netty.worker.threads`	int	Sets the number of threads for the event loop group.
`micronaut.server.netty.worker.io-ratio`	java.lang.Integer	Sets the I/O ratio.
`micronaut.server.netty.worker.executor`	java.lang.String	Sets the name of the executor.
`micronaut.server.netty.worker.prefer-native-transport`	boolean	Set whether to prefer the native transport if available
`micronaut.server.netty.worker.shutdown-quiet-period`	java.time.Duration	Set the shutdown quiet period
`micronaut.server.netty.worker.shutdown-timeout`	java.time.Duration	Set the shutdown timeout (must be >= shutdownQuietPeriod)

Configuration properties for CacheControlConfiguration

Property	Type	Description
`micronaut.server.netty.responses.file.cache-control`	NettyHttpServerConfiguration$FileTypeHandlerConfiguration$CacheControlConfiguration	Sets the cache control configuration.
`micronaut.server.netty.responses.file.cache-control.public`	boolean	Sets whether the cache control is public. Default value (false)

Configuration properties for FileTypeHandlerConfiguration

Property	Type	Description
`micronaut.server.netty.responses.file.cache-seconds`	int	Cache Seconds. Default value (60).

Configuration properties for CacheControlConfiguration

Property	Type	Description
`netty.responses.file.cache-control`	FileTypeHandlerConfiguration$CacheControlConfiguration	Sets the cache control configuration.
`netty.responses.file.cache-control.public`	boolean	Sets whether the cache control is public. Default value (false)

Configuration properties for NettyHttpServerConfiguration

Property	Type	Description
`micronaut.server.netty.child-options`	java.util.Map	Sets the Netty child worker options.
`micronaut.server.netty.options`	java.util.Map	Sets the channel options.
`micronaut.server.netty.max-initial-line-length`	int	Sets the maximum initial line length for the HTTP request. Default value (4096).
`micronaut.server.netty.max-header-size`	int	Sets the maximum size of any one header. Default value (8192).
`micronaut.server.netty.max-chunk-size`	int	Sets the maximum size of any single request chunk. Default value (8192).
`micronaut.server.netty.max-h2c-upgrade-request-size`	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>
`micronaut.server.netty.chunked-supported`	boolean	Sets whether chunked transfer encoding is supported. Default value (true).
`micronaut.server.netty.validate-headers`	boolean	Sets whether to validate incoming headers. Default value (true).
`micronaut.server.netty.initial-buffer-size`	int	Sets the initial buffer size. Default value (128).
`micronaut.server.netty.log-level`	io.netty.handler.logging.LogLevel	Sets the Netty log level.
`micronaut.server.netty.compression-threshold`	int	Sets the minimum size of a request body must be in order to be compressed. Default value (1024).
`micronaut.server.netty.compression-level`	int	Sets the compression level (0-9). Default value (6).
`micronaut.server.netty.use-native-transport`	boolean	Sets whether to use netty’s native transport (epoll or kqueue) if available . Default value (false).
`micronaut.server.netty.fallback-protocol`	java.lang.String	Sets the fallback protocol to use when negotiating via ALPN.
`micronaut.server.netty.keep-alive-on-server-error`	boolean	Whether to send connection keep alive on internal server errors. Default value ({@value DEFAULT_KEEP_ALIVE_ON_SERVER_ERROR}).
`micronaut.server.netty.pcap-logging-path-pattern`	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!

Configuration properties for Parent

Property	Type	Description
`micronaut.server.netty.parent.event-loop-group`	java.lang.String	Sets the name to use.
`micronaut.server.netty.parent.threads`	int	Sets the number of threads for the event loop group.
`micronaut.server.netty.parent.io-ratio`	java.lang.Integer	Sets the I/O ratio.
`micronaut.server.netty.parent.executor`	java.lang.String	Sets the name of the executor.
`micronaut.server.netty.parent.prefer-native-transport`	boolean	Set whether to prefer the native transport if available
`micronaut.server.netty.parent.shutdown-quiet-period`	java.time.Duration	Set the shutdown quiet period
`micronaut.server.netty.parent.shutdown-timeout`	java.time.Duration	Set the shutdown timeout (must be >= shutdownQuietPeriod)
`micronaut.server.netty.parent`	NettyHttpServerConfiguration$Parent	Sets the parent event loop configuration.

Configuration properties for FileTypeHandlerConfiguration

Property	Type	Description
`netty.responses.file.cache-seconds`	int	Cache Seconds. Default value (60).

Jackson Databind Config Properties

Configuration properties for JacksonConfiguration

Property	Type	Description
`jackson.module-scan`	boolean	Sets whether to scan for modules or not (defaults to true).
`jackson.bean-introspection-module`	boolean	Whether the BeanIntrospection should be used for reflection free object serialialization/deserialialization.
`jackson.date-format`	java.lang.String	Sets the default date format to use.
`jackson.locale`	java.util.Locale	Sets the locale to use.
`jackson.time-zone`	java.util.TimeZone	Sets the timezone to use.
`jackson.array-size-threshold`	int	Sets the array size threshold for data binding. Default value (100).
`jackson.serialization`	java.util.Map	Sets the serialization features to use.
`jackson.deserialization`	java.util.Map	Sets the deserialization features to use.
`jackson.mapper`	java.util.Map	Sets the object mapper features to use.
`jackson.parser`	java.util.Map	Sets the parser features to use.
`jackson.generator`	java.util.Map	Sets the generator features to use.
`jackson.factory`	java.util.Map	Sets the factory features to use.
`jackson.serialization-inclusion`	com.fasterxml.jackson.annotation.JsonInclude$Include	Sets the serialization inclusion mode.
`jackson.default-typing`	com.fasterxml.jackson.databind.ObjectMapper$DefaultTyping	Sets the global defaultTyping using for Polymorphic handling.
`jackson.property-naming-strategy`	com.fasterxml.jackson.databind.PropertyNamingStrategy	Sets the property naming strategy.
`jackson.always-serialize-errors-as-list`	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.
`jackson.trim-strings`	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.

Management Config Properties

Configuration properties for EndpointConfiguration

Property	Type	Description
`endpoints.*.enabled`	java.lang.Boolean	Sets whether the endpoint is enabled.
`endpoints.*.sensitive`	java.lang.Boolean	Sets whether the endpoint is sensitive.

Configuration properties for DiskSpaceIndicatorConfiguration

Property	Type	Description
`endpoints.health.disk-space.enabled`	boolean	Default value (true).
`endpoints.health.disk-space.path`	java.io.File	Default value (".").
`endpoints.health.disk-space.threshold`	long	Default value (1024L * 1024 * 10 ⇒ 10MB).

Configuration properties for EndpointDefaultConfiguration

Property	Type	Description
`endpoints.all.enabled`	java.lang.Boolean	Sets whether the endpoint is enabled.
`endpoints.all.sensitive`	java.lang.Boolean	Sets whether the endpoint is sensitive.
`endpoints.all.port`	java.lang.Integer	Sets the port to expose endpoints via.
`endpoints.all.path`	java.lang.String	The endpoints base path. Default value ("/").

Configuration properties for LoggersEndpoint

Property	Type	Description
`endpoints.loggers.write-sensitive`	boolean	Determines whether modifications to the log level should require authentication. Default value (true).

Configuration properties for StatusConfiguration

Property	Type	Description
`endpoints.health.status.http-mapping`	java.util.Map	Set how HealthStatus map to HttpStatus codes.

Configuration properties for HealthEndpoint

Property	Type	Description
`endpoints.health.details-visible`	DetailsVisibility	Sets the visibility policy for health information.

Configuration properties for DiscoveryClientHealthIndicatorConfiguration

Property	Type	Description
`endpoints.health.discovery-client.enabled`	boolean	If health indicator should be enabled. Default is true.

Router Config Properties

Configuration properties for HeaderVersionResolverConfiguration

Property	Type	Description
`micronaut.router.versioning.header.enabled`	boolean	Sets whether headers should be searched for a version.
`micronaut.router.versioning.header.names`	java.util.List	Sets which headers should be searched for a version.

Configuration properties for StaticResourceConfiguration

Property	Type	Description
`micronaut.router.static-resources.*.enabled`	boolean	Sets whether this specific mapping is enabled. Default value (true).
`micronaut.router.static-resources.*.paths`	java.util.List	A list of paths either starting with classpath: or file: . You can serve files from anywhere on disk or the classpath. For example to serve static resources from src/main/resources/public , you would use classpath:public as the path.
`micronaut.router.static-resources.*.mapping`	java.lang.String	The path resources should be served from. Uses ant path matching. Default value ("/**").

Configuration properties for RoutesVersioningConfiguration

Property	Type	Description
`micronaut.router.versioning.enabled`	boolean	Enables the version based route matches filtering.
`micronaut.router.versioning.default-version`	java.lang.String	Sets the version to use if the version cannot be resolved. Default value (null).

Configuration properties for ParameterVersionResolverConfiguration

Property	Type	Description
`micronaut.router.versioning.parameter.enabled`	boolean	Sets whether parameter should be searched for a version.
`micronaut.router.versioning.parameter.names`	java.util.List	Sets which parameter should be searched for a version.

Runtime Config Properties

Configuration properties for HeartbeatConfiguration

Property	Type	Description
`micronaut.heartbeat.interval`	java.time.Duration	Default value (15 seconds).
`micronaut.heartbeat.enabled`	boolean	Default value (true).

Configuration properties for DigitalOceanMetadataConfiguration

Property	Type	Description
`micronaut.application.digitalocean.metadata.url`	java.lang.String	Default value ("http://169.254.169.254/metadata/v1.json").
`micronaut.application.digitalocean.metadata.enabled`	boolean	Default value (true).

Session Config Properties

Configuration properties for HttpSessionConfiguration

Property	Type	Description
`micronaut.session.http.remember-me`	boolean	Default value (false).
`micronaut.session.http.base64-encode`	boolean	Default value (true).
`micronaut.session.http.cookie-max-age`	java.time.temporal.TemporalAmount	Sets the maximum age of the cookie.
`micronaut.session.http.cookie-secure`	java.lang.Boolean	Sets the secure status of the cookie. Delegates to http if not set.
`micronaut.session.http.cookie-path`	java.lang.String	Set the cookie path to use. Default value ("/").
`micronaut.session.http.domain-name`	java.lang.String	Set the domain name to use for the cookie
`micronaut.session.http.cookie-name`	java.lang.String	Default value ("SESSION").
`micronaut.session.http.prefix`	java.lang.String	Set the prefix to use when serializing session ID
`micronaut.session.http.header-names`	java.lang.String[]	Default values ([{@value io.micronaut.http.HttpHeaders#AUTHORIZATION_INFO}, {@value io.micronaut.http.HttpHeaders#X_AUTH_TOKEN}]).
`micronaut.session.http.cookie-domain`	java.lang.String	Set the domain name to use for the cookie
`micronaut.session.http.cookie-same-site`	SameSite	Determines if this this Cookie can be sent along cross-site requests. For more information, please look <a href="https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-05">here</a>

Configuration properties for SessionConfiguration

Property	Type	Description
`micronaut.session.max-inactive-interval`	java.time.Duration	Set the maximum inactive interval. Default value (30 minutes).
`micronaut.session.max-active-sessions`	java.lang.Integer	Sets the maximum number of active sessions.
`micronaut.session.prompt-expiration`	boolean	Set if prompt expiration is enabled.
`micronaut.session.executor-service`	BeanProvider	Set the executor service.

Validation Config Properties

Configuration properties for DefaultValidatorConfiguration

Property	Type	Description
`micronaut.validator.enabled`	boolean	Sets whether Micronaut’s validator is enabled.