Payara Micro Command Line Options

All of the options listed below are case-insensitive from version; 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.


Sets user defined log format for the access log.

--additionalrepository <repo-url>

Specifies an additional repository to search for deployable artefacts in.


Enables auto-binding for the HTTP port.


--autobindrange <number-of-ports>

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



Enables auto-binding for the HTTPS port.


--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.


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 Health Check Service.



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

--group <group-name>

Sets the instance’s group.


Displays the configuration options and then exits.

If not set, this option is not used.


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


--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


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



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.


--mcaddress <multicast-address>

Sets the cluster groups.

--mcport <multicast-port>

Sets the cluster multicast port.


--minhttpthreads <min-thread-count>

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


--name <instance-name>

Sets the instance name.

Generated Universally Unique Identifier (Adjective-Fish).


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



Disables clustering for this instance.


--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.


--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

--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.


--systemproperties <file-path>

Reads system properties from a file.

--unpackdir <directory-path>

Unpack the Nested Jar runtime jars to the specified directory.

Unpack to


Displays the version information

results matching ""

    No results matching ""