System Properties

Below is a non-exhaustive set of useful properties, which may be available depending on which fractions your application uses.

Note
For a full set of supported options, please consult the documentation for each fraction and the javadocs on class SwarmProperties.java

General

Name Description Default

swarm.bind.address

Interface to bind servers

0.0.0.0

swarm.port.offset

Sets a global port adjustment

0

swarm.deployment.timeout

Timeout, in seconds, to wait for a deployment to occur

300

swarm.export.deployment

Causes a deployed artifact to be dumped to disk when swarm starts, for debugging

false

swarm.debug.port

If provided, the swarm process will pause for debugging on the given port. This option is only available when running an Arquillian test or mvn wildfly-swarm:run, not when executing java -jar. The latter requires normal Java debug agent parameters

none

Undertow

Name Description Default

swarm.http.port

Sets the port for the HTTP server

8080

swarm.https.port

Sets the port for the HTTPS server

8443

swarm.https.certificate.generate

Enables HTTPS and generates a self-signed certificate

If true, generates a self-signed certificate for development purposes

swarm.https.certificate.generate.host

The host used in the self-signed certificate if swarm.https.certificate.generate is true

localhost

swarm.context.path

Sets the context path for the deployed application

/

Databases

For the H2, MySQL and Postgres database fractions, the follow properties are supported to configure the datasource.

Name Description Default

swarm.ds.name

Name of the datasource (e.g. ExampleDS)

ExampleDS

swarm.ds.username

Username to access the database

driver specific

swarm.ds.password

Password to access the database

driver specific

swarm.ds.connection.url

JDBC connection URL

driver specific