Payara Micro Command Line Options

All of the options listed below are case-insensitive from version 4.1.1.171; prior versions need the option to be set with camelCase notation

Configuration Option Description Default Value

--accesslog <directory-path>

Sets user defined directory path for the access log.

--accesslogformat

Sets user defined log format for the access log.

--additionalrepository <repo-url>

Specifies an additional repository to search for deployable artefacts in.

--addjars <jar-path>

Specifies one or multiple path sources for additional JAR files to include in the instance’s classpath

--autobindhttp

Enables auto-binding for the HTTP port.

false

--autobindrange <number-of-ports>

Sets the range for HTTP and HTTPS port auto-binding.

5

--autobindssl

Enables auto-binding for the HTTPS port.

false

--clustername <cluster-name>

Sets the cluster group name.

--clusterpassword <cluster-password>

Sets the cluster group password.

--deploy <file-path>

Specifies a WAR file to deploy.

If not set, has no value and is not used.

--deploydir <directory-path>

Sets a directory which will be scanned for EAR, WAR, and RAR files for auto-deployment.

If not set, has no value and is not used.

--deployfromgav <list-of-artefacts>

Specifies a comma separated groupId, artifactId, versionNumber of an artefact to deploy from a repository.

--deploymentdir <directory-path>

See --deploydir.

--disablephonehome

Disables the Phone Home service for this instance.

If not set, the Phone Home service is active.

--domainconfig <file-path>

Overrides the server configuration with an alternative domain.xml file.

If not set, the domain.xml contained in the Payara Micro JAR is used.

--enablehealthcheck <boolean>

enables/disables the HealthCheck Service.

false

--enablerequesttracing

Enables the Request Tracing Service and optionally sets the threshold unit and/or value.

--group <group-name>

Sets the instance’s group.

--help

Displays the configuration options and then exits.

If not set, this option is not used.

--hostaware

Enable Host Aware Partitioning. When enabled cluster backups will not be stored on members with the same IP Address.

false

--hzconfigfile <file-path>

Sets the Hazelcast configuration file to use for overriding the built-in Hazelcast cluster configuration.

If not set, the built-in Hazelcast configuration file is used.

--instancegroup <group-name>

See --group

--lite

Sets the micro container to lite mode, which means it clusters with other Payara Micro instances but does not store clustered data.

false

--logo

Reveals either the #BadAssFish or a custom logo on boot.

--logproperties <file-path>

Allows user to set their own logging properties file.

--logtofile <file-path>

Outputs all the Log entries to a user defined file.

--maxhttpthreads <max-thread-count>

Sets the maximum number of threads in the HTTP thread pool.

10

--mcaddress <multicast-address>

Sets the cluster groups.

--mcport <multicast-port>

Sets the cluster multicast port.

2904

--minhttpthreads <min-thread-count>

Sets the minimum number of threads in the HTTP thread pool.

10

--name <instance-name>

Sets the instance name.

Generated Universally Unique Identifier (Adjective-Fish).

--nested

Do not unpack the Nested Jars when booting the server. This is generally slower than unpacking the runtime.

false

--nocluster

Disables clustering for this instance.

false

--outputuberjar <file-path>

Packages up an Uber JAR at the specified path based on the provided command line arguments and exit.

--port <http-port-number>

Sets the HTTP port that the instance will bind to.

8080

--postbootcommandfile <file-path>

Provides a file of asadmin commands to run after booting the server.

--postdeploycommandfile <file-path>

Provides a file of asadmin commands to run after all deployments have completed.

--prebootcommandfile <file-path>

Provides a file of asadmin commands to run before booting the server.

--requesttracingthresholdunit <threshold-unit-notation>

Sets the time unit for the requestTracingThresholdValue option, i.e. SECONDS, ms, days etc.

--requesttracingthresholdvalue <threshold-unit-value>

Sets the threshold time before a request is traced.

--rootdir <directory-path>

Sets the root configuration directory and saves the configuration across restarts.

Defaults to java.io.tmpdir.

--sslport <ssl-port-number>

Sets the HTTPs port that the instance will bind to.

If not set, has no value and HTTPS is disabled.

--startport <cluster-start-port-number>

Sets the cluster start port number.

5900

--systemproperties <file-path>

Reads system properties from a file.

--unpackdir <directory-path>

Unpack the Nested Jar runtime jars to the specified directory.

Unpack to java.io.tmpdir.

--version

Displays the version information