Customizing Payara Micro with Command-Line Options

Photo of Luqman Saeed by Luqman Saeed

Payara Micro is a microservices optimised, cloud-first Jakarta EE runtime capable of executing WAR files directly from the command line, eliminating the need for a conventional application server setup. This efficient method, coupled with its versatility and extensive functionality, makes Payara Micro an ideal choice for simplifying your Jakarta EE development process. Its wide array of command-line options is designed to simplify configuration and management, further enhancing its appeal.

Payara Enterprise   Free Trial

Key Command-Line Options

From setting up custom access logs to deploying applications with ease, Payara Micro (download free Enterprise trial here) provides a comprehensive set of command-line options to cater to various operational needs. Let's dive into some of the pivotal options available:

Deployment and Configuration

  • --deploy <file-path>[:<context-path>]: Quickly deploy WAR files, with the option to specify a custom context path for each application.
  • --contextroot <context-path>: Set the default context root for applications, enhancing URL management.
  • --domainconfig <file-path>: Override the default server configuration with your own domain.xml, allowing for custom server setups during development.

Clustering and Networking

  • --clustermode [multicast|tcpip|domain]: Choose your preferred cluster discovery mode, facilitating seamless service discovery in various environments.
  • --autobindhttp and --autobindssl: Enable auto-binding for HTTP and HTTPS ports, respectively, simplifying port management.
  • --mcaddress <multicast-address> and --mcport <multicast-port>: Specify multicast group address and port for cluster communication.

Logging and Monitoring

  • --accesslog <directory-path>: Define a custom directory for access logs, aiding in log management and analysis.
  • --logproperties <file-path>: Utilize a custom logging properties file, offering flexibility in log configuration.
  • --enablehealthcheck <boolean>: Enable or disable the HealthCheck service, ensuring the health and performance of your applications can be monitored.

Security and SSL

  • --sslport <ssl-port-number>: Set the HTTPS port, enabling secure communication.
  • --sslcert <certificate-name>: Specify the SSL certificate to be used from the keystore, bolstering application security.


  • --addlibs <file-or-directory-path>: Add specific JAR files to the classloader or Uber JAR, extending the application's capabilities.
  • --outputuberjar <file-path>: Create an Uber JAR based on the provided command-line arguments, facilitating easy distribution and deployment.
  • --help: Display the configuration options, offering immediate assistance right from the terminal.

Simplifying Development with Payara Micro

Payara Micro's command-line options are designed with developer productivity in mind. These options allow you to:

  • Automate Deployment: Automatically deploy applications without manual intervention, speeding up the development cycle.
  • Customise Configurations: Tailor server and application configurations to meet specific requirements, ensuring optimal performance and security.
  • Streamline Clustering: Easily set up and manage clusters, improving application scalability and reliability.
  • Enhance Monitoring: Monitor application health and performance with built-in or custom logs, helping to quickly identify and resolve issues.


Payara Micro provides you with comprehensive command-line capabilities, offering a powerful toolkit to streamline your Jakarta EE application deployments. By leveraging these features, you'll enjoy an enhanced development workflow, reduced configuration efforts, and ensure smooth, efficient operation of your applications. Download Payara Micro today, read the docs and get productive with your Jakarta EE development!