Payara Server Documentation

Comprehensive documentation of how to operate and manage a Payara Server installation composed of the following subsections:

General Administration

Details the basics of how to manage the configuration and runtime settings of Payara Server.

Deployment Planning

Contains instructions and recommendations on how to plan an application deployment in Payara Server.

Application Deployment

Details how application deployments work in Payara Server.

High Availability

Details how to configure and use the high-availability features of Payara Server on distributed environments.

Security Guide

A comprehensive guide that offers basic recommendations and advice on how to secure a Payara Server installation.

Command Reference

A complete reference manual of alf available Asadmin CLI commands.


Documents the features of all available extensions for Payara Server and how to use them.

Upgrade Guide

A guide with recommendations and strategies for upgrading Payara Server across versions.

Documentation Conventions

The following conventions are applied through the pages in this section to improve readability and familiarity with how Payara Server operates.

Symbol Conventions

The following table explains symbols that might be used in this section.

Symbol Description Example Meaning

[ ]

Contains optional arguments and command options.

ls [-l]

The -l option is not required.

{ | }

Contains a set of choices for a required command option.

-d {y|n}

The -d option requires that you use either the y argument or the n argument.

${ }

Indicates a variable reference or a placeholder reference for a default path.


References the value of the com.sun.javaRoot variable.


Joins simultaneous multiple keystrokes.


Press the `Control key while you press the A key.


Joins consecutive multiple keystrokes.


Press the Control key, release it, and then press the subsequent keys.

Indicates menu item selection in a graphical user interface.

File → New → Templates

From the File menu, choose New. From the New submenu, choose Templates.

Default Paths and File Names

The following table describes the default paths and file names that are used in this book.

Placeholder Description Default Value


Represents the base installation directory for Payara Server.

In configuration files, as-install is represented as follows:


Installations on a Linux operating system, and macOS operating system:


Installations on a Windows operating system:



Represents the parent of the base installation directory for Payara Server.

Installations on a Linux operating system, and Mac operating system:


Installations on a Windows operating system:



Represents the directory in which a domain is created by default.



Represents the directory in which a domain’s configuration is stored.

In configuration files, domain-dir is represented as follows: ${com.sun.aas.instanceRoot}



Represents the directory for a configured node.



Represents the directory for a server instance.


Docker Images

Payara Services Limited provides official Payara Server Docker Images which are updated every release.

These images are hosted on Docker hub in the following locations:

Payara Enterprise customers have access to a private Docker repository containing Payara Enterprise Edition equivalent images, which are also released and updated every month.