Dev services for Amazon Services :: Quarkiverse Documentation

Choosing a Stack Provider

Dev Services for Amazon Services supports multiple stack providers:

Floci: A lightweight AWS service mock library built with Quarkus. It is the default stack provider. Not all services are supported yet, but it is actively developed and new services are added regularly.
MiniStack: An alternative stack provider that runs real services in a containerized environment.
Moto: A lightweight AWS service mock library, using the motoserver container (historically used for Cognito User Pools)
LocalStack: An alternative stack provider, supported up to version 4.13 (latest free community version).

Dev Services for Amazon Services does not verify if the chosen stack actually implements a mock for a given service. It will start the container and provide the configuration to the client to connect to it, regardless of whether the service is actually supported by that stack provider.

You can configure the stack provider globally or per-service:

# Global configuration (default: floci)
quarkus.aws.devservices.provider=floci

# Per-service configuration (overrides global setting)
quarkus.dynamodb.devservices.provider=ministack
quarkus.cognito-user-pools.devservices.provider=moto
quarkus.s3.devservices.provider=floci

Generic AWS SDK clients

The generic AWS SDK extension uses the same stack providers and global quarkus.aws.devservices settings described in this guide. Generic clients inherit the global stack provider. A named client can select another provider with quarkus.aws."client-name".devservices.provider. Each selected stack starts automatically; clients selecting the same provider share its container settings under quarkus.aws.devservices.<provider>.

# Default clients use Floci.
quarkus.aws.devservices.provider=floci
# Clients injected with @AmazonClient("other") use MiniStack.
quarkus.aws."other".devservices.provider=ministack

Use different client names when services require different stacks. The same name selects the same provider across services; there is no per-service override for generic clients.

Enabling / Disabling Dev Services for Amazon Services

Dev Services for Amazon Services is automatically enabled for each extensions added to pom.xml except in the following situations:

quarkus.devservices.enabled is set to false
devservices.enabled is set to false per extension (eg. quarkus.dynamodb.devservices.enabled=false)
the endpoint-override is configured (eg. quarkus.dynamodb.endpoint-override=http://localhost:4566)
Your environment does not support Docker. In test mode, it will cause the test to fail. Either disable Dev Services or configure the endpoint-override.

Every extension provides a Dev Service, including for services that none of the supported stack providers emulates. As explained in the WARNING above, Dev Services starts the container without checking that the selected stack actually emulates the service. If none of the supported stacks does, disable Dev Services for the service with quarkus.<service>.devservices.enabled=false and use your AWS account or set the endpoint-override.

Configuration precedence and credentials

This applies to both dedicated extensions and the generic AWS SDK extension. Dev Services supplies connection defaults, not mandatory overrides: explicit properties in application.properties, environment variables or JVM system properties take precedence over the values supplied by Dev Services.

Removing only endpoint-override while leaving production credentials or a profile provider configured can send those credentials to the local stack, fail to resolve credentials, or cause authentication/account errors with the selected provider.

If you want to keep these settings in application.properties, scope them to the production profile so that production credentials are not active in dev or test mode:

# Dedicated extension
%prod.quarkus.sesv2.aws.region=eu-west-1
%prod.quarkus.sesv2.aws.credentials.type=profile
%prod.quarkus.sesv2.aws.credentials.profile-provider.profile-name=production

# Generic extension (alternative to the dedicated configuration above)
%prod.quarkus.aws.region=eu-west-1
%prod.quarkus.aws.credentials.type=profile
%prod.quarkus.aws.credentials.profile-provider.profile-name=production

Shared services

Stack containers are shared between Quarkus applications in dev mode by default. Set quarkus.aws.devservices.shared=false to disable sharing globally. A stack-specific setting overrides the global value:

# Disable sharing for all stack providers
quarkus.aws.devservices.shared=false

# Override the global setting for individual stack providers
quarkus.aws.devservices.floci.shared=false
quarkus.aws.devservices.ministack.shared=false
quarkus.aws.devservices.moto.shared=false
quarkus.aws.devservices.localstack.shared=false

In test mode, sharing is always disabled. Containers are identified by the quarkus-dev-service-{stack} label, where {stack} is the provider name (floci, ministack, moto, or localstack). Each stack provider uses its own name by default. To use multiple shared containers for the same provider, set its service-name property (for example, quarkus.aws.devservices.floci.service-name).

Configuring the image

Dev Services for Amazon Services uses different default images depending on the stack provider:

Floci: floci/floci:latest (latest version)
MiniStack: ministackorg/ministack:latest (not a fixed version as MiniStack is still in early development)
Moto: motoserver/moto:latest (latest version)
LocalStack: localstack/localstack:4.13

You can configure the image and version using the stack-specific properties:

# Global Floci configuration
quarkus.aws.devservices.floci.image-name=floci/floci:latest

# Global MiniStack configuration
quarkus.aws.devservices.ministack.image-name=ministackorg/ministack:latest

# Global Moto configuration
quarkus.aws.devservices.moto.image-name=motoserver/moto:latest

# Global LocalStack configuration
quarkus.aws.devservices.localstack.image-name=localstack/localstack:4.13

# Per-service Floci configuration (overrides global)
quarkus.dynamodb.devservices.floci.image-name=floci/floci:latest

# Per-service MiniStack configuration (overrides global)
quarkus.dynamodb.devservices.ministack.image-name=ministackorg/ministack:latest

# Per-service Moto configuration (overrides global)
quarkus.dynamodb.devservices.moto.image-name=motoserver/moto:latest

# Per-service LocalStack configuration (overrides global)
quarkus.dynamodb.devservices.localstack.image-name=localstack/localstack:4.13

LocalStack Auth Token

To use LocalStack latest version, you need to configure the image and provide your auth token:

# Use the latest LocalStack image
quarkus.aws.devservices.localstack.image-name=localstack/localstack:latest

# Set the authentication token as a container environment variable
quarkus.aws.devservices.localstack.container-env.LOCALSTACK_AUTH_TOKEN=your-auth-token-here

You can obtain your LocalStack Pro authentication token from your LocalStack account dashboard. The token is required to access Pro features and services.

Specific configuration

Dev Services for Amazon Services can support specific properties sent to the container. It can be globally applied to all containers or be specified per service as follows:

# Global Floci configuration
quarkus.aws.devservices.floci.container-properties.FLOCI_SERVICES_S3_ENFORCE_AUTH=true

# Global MiniStack configuration
quarkus.aws.devservices.ministack.container-properties.SOME_PROPERTY=value

# Global Moto configuration
quarkus.aws.devservices.moto.container-properties.SOME_MOTO_PROPERTY=value

# Global LocalStack configuration
quarkus.aws.devservices.localstack.container-properties.START_WEB=0

# Per-service Floci configuration (overrides global)
quarkus.s3.devservices.floci.container-properties.FLOCI_SERVICES_S3_ENFORCE_AUTH=true

# Per-service MiniStack configuration (overrides global)
quarkus.dynamodb.devservices.ministack.container-properties.SOME_PROPERTY=value

# Per-service Moto configuration (overrides global)
quarkus.dynamodb.devservices.moto.container-properties.SOME_MOTO_PROPERTY=value

# Per-service LocalStack configuration (overrides global)
quarkus.dynamodb.devservices.localstack.container-properties.DYNAMODB_HEAP_SIZE=1G

Refer to the Floci documentation for Floci configuration: https://github.com/floci-io/floci. For MiniStack, refer to its documentation. For Moto, refer to the Moto documentation. Refer to the LocalStack documentation for LocalStack configuration: https://docs.localstack.cloud/aws/capabilities/config/configuration/. Note that not all environment variables are supported and some may affect Dev Services for Amazon Services.

Additional services

To start additional services for which a Quarkus extension does not exist or is not imported in the project, use the additional-services property:

# Global Floci configuration
quarkus.aws.devservices.floci.additional-services."kinesis".enabled=true
quarkus.aws.devservices.floci.additional-services."redshift".enabled=true

# Global MiniStack configuration
quarkus.aws.devservices.ministack.additional-services."kinesis".enabled=true
quarkus.aws.devservices.ministack.additional-services."redshift".enabled=true

# Global LocalStack configuration
quarkus.aws.devservices.localstack.additional-services."kinesis".enabled=true
quarkus.aws.devservices.localstack.additional-services."redshift".enabled=true

The key is the name of the service to enable and must be a valid service name for the chosen stack provider.

Init scripts

You can configure init scripts to be executed during stack startup:

# Global Floci configuration
quarkus.aws.devservices.floci.init-scripts-folder=src/test/resources/floci-init
quarkus.aws.devservices.floci.init-scripts-classpath=init-scripts

# Global MiniStack configuration
quarkus.aws.devservices.ministack.init-scripts-folder=src/test/resources/ministack-init
quarkus.aws.devservices.ministack.init-scripts-classpath=init-scripts

# Global Moto configuration
quarkus.aws.devservices.moto.init-scripts-folder=src/test/resources/moto-init
quarkus.aws.devservices.moto.init-scripts-classpath=init-scripts

# Global LocalStack configuration
quarkus.aws.devservices.localstack.init-scripts-folder=src/test/resources/localstack-init
quarkus.aws.devservices.localstack.init-scripts-classpath=init-scripts

# Per-service Floci configuration (overrides global)
quarkus.dynamodb.devservices.floci.init-scripts-folder=src/test/resources/dynamodb-init

# Per-service MiniStack configuration (overrides global)
quarkus.dynamodb.devservices.ministack.init-scripts-folder=src/test/resources/dynamodb-init

# Per-service Moto configuration (overrides global)
quarkus.dynamodb.devservices.moto.init-scripts-folder=src/test/resources/dynamodb-init

# Per-service LocalStack configuration (overrides global)
quarkus.dynamodb.devservices.localstack.init-scripts-folder=src/test/resources/dynamodb-init

The init-scripts-folder property points to a folder containing init scripts, while init-scripts-classpath points to a classpath resource. The folder-based configuration takes precedence.

init-scripts-classpath is resolved against the classpath of the application when Dev Services starts. In dev mode, this classpath does not include src/test/resources: with scripts stored there, as the integration tests of this project do, the tests work but dev mode fails to start with Resource with path … could not be found. To use the same scripts in dev mode, store them in src/main/resources, or point init-scripts-folder to their folder, for example src/test/resources/floci-init.

To wait for the init scripts to complete before starting the application, make the last script print a specific message and configure it with the init-completion-msg property. Dev Services then waits for this message in the container logs:

quarkus.aws.devservices.floci.init-completion-msg=Init completed

Floci init scripts

Floci runs the init scripts from the /etc/floci/init/ready.d folder of the container, where Dev Services mounts the configured scripts. The default floci/floci image does not ship the AWS CLI. If your scripts use it, switch to the latest-compat image, which includes the AWS CLI and boto3:

quarkus.aws.devservices.floci.image-name=floci/floci:latest-compat
quarkus.aws.devservices.floci.init-scripts-classpath=floci-init
quarkus.aws.devservices.floci.init-completion-msg=#### Tests init completed

The AWS CLI is preconfigured to target the Floci endpoint, so the scripts can call it directly:

#!/bin/bash
aws sqs create-queue --queue-name quarkus
echo "#### Tests init completed"

Additional setup

Some extensions support additional configuration to be applied at startup. Refer to the extension documentation.

Global DevServices Configuration Reference

Configuration property fixed at build time - All other configuration properties are overridable at runtime

Configuration property	Type	Default
`quarkus.aws.devservices.floci.image-name` The Floci container image to use. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_IMAGE_NAME`	string	`floci/floci:latest`
`quarkus.aws.devservices.floci.enabled` If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless `aws.endpoint-override` is set. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_ENABLED`	boolean
`quarkus.aws.devservices.floci.shared` Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global `quarkus.aws.devservices.shared` value is used. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_SHARED`	boolean
`quarkus.aws.devservices.floci.service-name` The value of the `quarkus-dev-service-floci` label attached to the started container. This property is used when `shared` is set to `true`. In this case, before starting a container, Dev Services for Floci looks for a container with the `quarkus-dev-service-floci` label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the `quarkus-dev-service-floci` label set to the specified value. This property is used when you need multiple shared Floci containers. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_SERVICE_NAME`	string	`floci`
`quarkus.aws.devservices.floci.init-scripts-folder` Path to init scripts folder executed during stack startup. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_SCRIPTS_FOLDER`	string
`quarkus.aws.devservices.floci.init-scripts-classpath` Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_SCRIPTS_CLASSPATH`	string
`quarkus.aws.devservices.floci.init-completion-msg` Specific container log message to be waiting for stack init scripts completion. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_COMPLETION_MSG`	string
`quarkus.aws.devservices.floci.container-properties."environment-variable-name"` Environment variables that are passed to the container. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_`	Map<String,String>
`quarkus.aws.devservices.floci.port` Optional fixed port the stack will listen to. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_PORT`	int
`quarkus.aws.devservices.provider` The dev services stack provider to use. Supported values: "floci" (default), "localstack", "ministack", "moto" This is a global setting that can be overridden per-service using the service-specific devservices.provider configuration. Environment variable: `QUARKUS_AWS_DEVSERVICES_PROVIDER`	`floci`, `localstack`, `ministack`, `moto`	`floci`
`quarkus.aws.devservices.shared` Indicates if stack containers are shared by Dev Services. Defaults to `true`; stack-specific configuration can override this value with `quarkus.aws.devservices.<stack>.shared`. Environment variable: `QUARKUS_AWS_DEVSERVICES_SHARED`	boolean	`true`
`quarkus.aws.devservices.localstack.image-name` The LocalStack container image to use. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_IMAGE_NAME`	string	`localstack/localstack:4.13`
`quarkus.aws.devservices.localstack.enabled` If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless `aws.endpoint-override` is set. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ENABLED`	boolean
`quarkus.aws.devservices.localstack.shared` Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global `quarkus.aws.devservices.shared` value is used. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_SHARED`	boolean
`quarkus.aws.devservices.localstack.service-name` The value of the `quarkus-dev-service-localstack` label attached to the started container. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_SERVICE_NAME`	string	`localstack`
`quarkus.aws.devservices.localstack.init-scripts-folder` Path to init scripts folder executed during stack startup. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_SCRIPTS_FOLDER`	string
`quarkus.aws.devservices.localstack.init-scripts-classpath` Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_SCRIPTS_CLASSPATH`	string
`quarkus.aws.devservices.localstack.init-completion-msg` Specific container log message to be waiting for stack init scripts completion. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_COMPLETION_MSG`	string
`quarkus.aws.devservices.localstack.container-properties."environment-variable-name"` Environment variables that are passed to the container. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_`	Map<String,String>
`quarkus.aws.devservices.localstack.port` Optional fixed port the stack will listen to. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_PORT`	int
`quarkus.aws.devservices.ministack.image-name` The MiniStack container image to use. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_IMAGE_NAME`	string	`ministackorg/ministack:latest`
`quarkus.aws.devservices.ministack.enabled` If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless `aws.endpoint-override` is set. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_ENABLED`	boolean
`quarkus.aws.devservices.ministack.shared` Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global `quarkus.aws.devservices.shared` value is used. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_SHARED`	boolean
`quarkus.aws.devservices.ministack.service-name` The value of the `quarkus-dev-service-ministack` label attached to the started container. This property is used when `shared` is set to `true`. In this case, before starting a container, Dev Services for MiniStack looks for a container with the `quarkus-dev-service-ministack` label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the `quarkus-dev-service-ministack` label set to the specified value. This property is used when you need multiple shared MiniStack containers. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_SERVICE_NAME`	string	`ministack`
`quarkus.aws.devservices.ministack.init-scripts-folder` Path to init scripts folder executed during stack startup. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_SCRIPTS_FOLDER`	string
`quarkus.aws.devservices.ministack.init-scripts-classpath` Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_SCRIPTS_CLASSPATH`	string
`quarkus.aws.devservices.ministack.init-completion-msg` Specific container log message to be waiting for stack init scripts completion. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_COMPLETION_MSG`	string
`quarkus.aws.devservices.ministack.container-properties."environment-variable-name"` Environment variables that are passed to the container. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_`	Map<String,String>
`quarkus.aws.devservices.ministack.port` Optional fixed port the stack will listen to. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_PORT`	int
`quarkus.aws.devservices.moto.image-name` The Moto container image to use. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_IMAGE_NAME`	string	`motoserver/moto:latest`
`quarkus.aws.devservices.moto.enabled` If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless `aws.endpoint-override` is set. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_ENABLED`	boolean
`quarkus.aws.devservices.moto.shared` Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global `quarkus.aws.devservices.shared` value is used. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_SHARED`	boolean
`quarkus.aws.devservices.moto.service-name` The value of the `quarkus-dev-service-moto` label attached to the started container. This property is used when `shared` is set to `true`. In this case, before starting a container, Dev Services for Moto looks for a container with the `quarkus-dev-service-moto` label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the `quarkus-dev-service-moto` label set to the specified value. This property is used when you need multiple shared Moto containers. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_SERVICE_NAME`	string	`moto`
`quarkus.aws.devservices.moto.init-scripts-folder` Path to init scripts folder executed during stack startup. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_INIT_SCRIPTS_FOLDER`	string
`quarkus.aws.devservices.moto.init-scripts-classpath` Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_INIT_SCRIPTS_CLASSPATH`	string
`quarkus.aws.devservices.moto.init-completion-msg` Specific container log message to be waiting for stack init scripts completion. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_INIT_COMPLETION_MSG`	string
`quarkus.aws.devservices.moto.container-properties."environment-variable-name"` Environment variables that are passed to the container. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_`	Map<String,String>
`quarkus.aws.devservices.moto.port` Optional fixed port the stack will listen to. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_PORT`	int
`quarkus.aws.devservices.floci.additional-services."service-name".enabled` If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with `provider`. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED`	boolean
`quarkus.aws.devservices.floci.additional-services."service-name".container-properties."container-properties"` Generic properties that are pass for additional container configuration. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_`	Map<String,String>
`quarkus.aws.devservices.floci.additional-services."service-name".provider` The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto" This allows per-service override of the global stack selection. Environment variable: `QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER`	`floci`, `localstack`, `ministack`, `moto`
`quarkus.aws.devservices.localstack.additional-services."service-name".enabled` If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with `provider`. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED`	boolean
`quarkus.aws.devservices.localstack.additional-services."service-name".container-properties."container-properties"` Generic properties that are pass for additional container configuration. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_`	Map<String,String>
`quarkus.aws.devservices.localstack.additional-services."service-name".provider` The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto" This allows per-service override of the global stack selection. Environment variable: `QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER`	`floci`, `localstack`, `ministack`, `moto`
`quarkus.aws.devservices.ministack.additional-services."service-name".enabled` If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with `provider`. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED`	boolean
`quarkus.aws.devservices.ministack.additional-services."service-name".container-properties."container-properties"` Generic properties that are pass for additional container configuration. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_`	Map<String,String>
`quarkus.aws.devservices.ministack.additional-services."service-name".provider` The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto" This allows per-service override of the global stack selection. Environment variable: `QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER`	`floci`, `localstack`, `ministack`, `moto`
`quarkus.aws.devservices.moto.additional-services."service-name".enabled` If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with `provider`. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED`	boolean
`quarkus.aws.devservices.moto.additional-services."service-name".container-properties."container-properties"` Generic properties that are pass for additional container configuration. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_`	Map<String,String>
`quarkus.aws.devservices.moto.additional-services."service-name".provider` The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto" This allows per-service override of the global stack selection. Environment variable: `QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER`	`floci`, `localstack`, `ministack`, `moto`

Configuration property

Type

Default

quarkus.aws.devservices.floci.image-name

The Floci container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_IMAGE_NAME

string

floci/floci:latest

quarkus.aws.devservices.floci.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ENABLED

boolean

quarkus.aws.devservices.floci.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global quarkus.aws.devservices.shared value is used.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_SHARED

boolean

quarkus.aws.devservices.floci.service-name

The value of the quarkus-dev-service-floci label attached to the started container. This property is used when shared is set to true. In this case, before starting a container, Dev Services for Floci looks for a container with the quarkus-dev-service-floci label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the quarkus-dev-service-floci label set to the specified value.

This property is used when you need multiple shared Floci containers.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_SERVICE_NAME

string

floci

quarkus.aws.devservices.floci.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.floci.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.floci.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.floci.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.floci.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_PORT

int

quarkus.aws.devservices.provider

The dev services stack provider to use. Supported values: "floci" (default), "localstack", "ministack", "moto"

This is a global setting that can be overridden per-service using the service-specific devservices.provider configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_PROVIDER

floci, localstack, ministack, moto

floci

quarkus.aws.devservices.shared

Indicates if stack containers are shared by Dev Services. Defaults to true; stack-specific configuration can override this value with quarkus.aws.devservices.<stack>.shared.

Environment variable: QUARKUS_AWS_DEVSERVICES_SHARED

boolean

true

quarkus.aws.devservices.localstack.image-name

The LocalStack container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_IMAGE_NAME

string

localstack/localstack:4.13

quarkus.aws.devservices.localstack.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ENABLED

boolean

quarkus.aws.devservices.localstack.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global quarkus.aws.devservices.shared value is used.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_SHARED

boolean

quarkus.aws.devservices.localstack.service-name

The value of the quarkus-dev-service-localstack label attached to the started container.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_SERVICE_NAME

string

localstack

quarkus.aws.devservices.localstack.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.localstack.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.localstack.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.localstack.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.localstack.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_PORT

int

quarkus.aws.devservices.ministack.image-name

The MiniStack container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_IMAGE_NAME

string

ministackorg/ministack:latest

quarkus.aws.devservices.ministack.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ENABLED

boolean

quarkus.aws.devservices.ministack.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global quarkus.aws.devservices.shared value is used.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_SHARED

boolean

quarkus.aws.devservices.ministack.service-name

The value of the quarkus-dev-service-ministack label attached to the started container. This property is used when shared is set to true. In this case, before starting a container, Dev Services for MiniStack looks for a container with the quarkus-dev-service-ministack label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the quarkus-dev-service-ministack label set to the specified value.

This property is used when you need multiple shared MiniStack containers.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_SERVICE_NAME

string

ministack

quarkus.aws.devservices.ministack.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.ministack.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.ministack.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.ministack.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.ministack.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_PORT

int

quarkus.aws.devservices.moto.image-name

The Moto container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_IMAGE_NAME

string

motoserver/moto:latest

quarkus.aws.devservices.moto.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ENABLED

boolean

quarkus.aws.devservices.moto.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode. If unset, the global quarkus.aws.devservices.shared value is used.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_SHARED

boolean

quarkus.aws.devservices.moto.service-name

The value of the quarkus-dev-service-moto label attached to the started container. This property is used when shared is set to true. In this case, before starting a container, Dev Services for Moto looks for a container with the quarkus-dev-service-moto label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the quarkus-dev-service-moto label set to the specified value.

This property is used when you need multiple shared Moto containers.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_SERVICE_NAME

string

moto

quarkus.aws.devservices.moto.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.moto.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.moto.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.moto.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.moto.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_PORT

int

quarkus.aws.devservices.floci.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with provider.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.floci.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.floci.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

floci, localstack, ministack, moto

quarkus.aws.devservices.localstack.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with provider.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.localstack.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.localstack.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

floci, localstack, ministack, moto

quarkus.aws.devservices.ministack.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with provider.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.ministack.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.ministack.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

floci, localstack, ministack, moto

quarkus.aws.devservices.moto.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. The local AWS stack is provided by the stack provider configured with provider.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.moto.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.moto.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "floci", "localstack", "ministack", "moto"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

floci, localstack, ministack, moto