All of the options listed below are case-insensitive starting from release 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.|"%client.name% %auth-user-name% %datetime% %request% %status% %response.length%" |
|--accessloginterval |
|Sets user defined access log write interval.|300 |
|--accesslogsuffix |
|Sets user defined simple date time suffix for access log filenames.|yyyy-MM-dd |
|--accesslogprefix |
|Sets user defined prefix for access log filenames.|
|--additionalrepository <repo-url> |
|Specifies an additional repository to search for deployable artefacts in. |
Supports BASIC authentication.
For example https://USER:PASSWORD@example.payara.fish/repositories/repo/.
You may also use aliases https://USER:{ALIAS=ALIAS_NAME}@example.payara.fish/repositories/repo/|
|--addjars <jar-path> |
|Deprecated. Use --addlibs instead|
|--addlibs <file or directory path>|<file-or-directory-path> add specified jar files into classloader, or packaged into an Uber JAR. Multiple files can be specified as colon separated values.|
|--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 |
|--clustermode |
|Modifies the cluster discovery mode of Payara Micro when finding members of the cluster. |
Options are:
-
multicast:group:port -
tcpip:host:port -
domain:dashost:port|multicast | |--clustername <cluster-name>| |Sets the cluster group name.| |--clusterpassword <cluster-password>|Sets the cluster group password.| |--contextroot <context-path>|Sets the context root of the application originating from the--deployoption given first that does not specify a context root itself. See | Define context root for more details. | |--copytouberjar <directory-path| |<directory-path> copy a directory into the root of an uber JAR| |--deploy <file-path>[:<context-path]| |Specifies a WAR file to deploy and optionally the context path to use for that application.| 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 separatedgroupId, artifactId, versionNumberof 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. | |--enableDynamicLogging| |Watch the logging properties file for changes, and apply them dynamically | |--enablehealthcheck <boolean>| |enables/disables the HealthCheck Service.|false | |--enablerequesttracing| |Enables the Request Tracing Service and optionally sets the threshold unit | and/or value.| |--enablerequesttracingadaptivesampling <boolean>|<boolean> Enables the adaptive sampling. Can also be enabled by configuring any one of the adaptive sampling configuration options| |--globalcontextroot <context-path>| |Sets the global context root of any deployed application. This will prepend the context root. See | Define global context root for more details.| |--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. |--hzinitialjoinwait <time in seconds>|Sets the time in seconds for Payara Micro to wait before attempting to join the | data grid.|1 |--hzPublicAddress <host-name or ip>|The Public Address to use for this Data Grid Node. Used when the node is behind a NAT| |--instancegroup <group-name>|See--group| |--interfaces|Specifies the Interfaces that the data grid discovery mode should use to listen. Can be comma separated, e.g. 127.0.0.1,192.168.0.| |--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 multicast group if multicast cluster mode is selected. See--clustermode.| |--mcport <multicast-port>| |Sets the cluster multicast port if multicast cluster mode is selected. See--clustermode.|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 | |--noHazelcast| |Disables Hazelcast and clustering for this instance.| false | |--nohostaware|Disables Host Aware Partitioning. See--hostaware| |--outputuberjar <file-path>| |Packages up an Uber JAR at the specified path based on the provided command | line arguments and exit.| |--outputlauncher| |Create launcherlaunch-micro.jarinto the root directory that is specified by--rootdirand 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.| |--requesttracingadaptivesamplingtargetcount|The target number of traces to sample per the configured time window | 6 | |--requesttracingadaptivesamplingtimeunit| The time unit for the adaptive sample time; ajava.util.concurrent.TimeUnitvalue (also in singular) or one of the short forms:ns,us/µs,ms,s,m/min/mins,hord. | MINUTES | |--requesttracingadaptivesamplingtimevalue| The period of time to attempt to hit the adaptive sample target count in | 1 | |--requesttracingthresholdunit <threshold-unit-notation>| |Sets the time unit for the requestTracingThresholdValue option, i.e.SECONDS, |ms,daysetc.| |--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 tojava.io.tmpdir. | |--secretsdir|Directory to read configuration from key-value files using the Microprofile config api.| |--shutdowngrace <duration-ms>| After server shutdown is initiated the server waits this period of time to finish ongoing requests before terminating. Currently, new requests are still accepted during this grace period. | 0 | |--sslport <ssl-port-number>| |Sets the HTTPs port that the instance will bind to.| If not set, has no value | and HTTPS is disabled. |--sslcert <certificate-name>| |Sets the SSL certificate name to be used from the keystore for SSL|s1as| |--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| |--warmup| |Exit the server immediately after configuration is done, applications are deployed and it’s ready to serve requests. | |======================================================================= |