Public | Automated Build

Last pushed: 12 hours ago
Short Description
Image for the full profile of Payara Server
Full Description

Updated repository for Payara Dockerfiles. This repository is for the Full Profile of Payara Server.

Supported tags and respective Dockerfile links

  • latest
    • contains latest released version of Payara Server Full Profile
  • prerelease
    • contains nightly build of Payara Server Full Profile from the master branch (updated daily)
  • other tags correspond to past releases of Payara Server Full Profile matched by short version number

Usage

Quick start

To boot the default domain with HTTP listener exported on port 8080:

docker run -p 8080:8080 payara/server-full

The Docker container specifies the default entry point, which starts the default domain domain1 in foreground so that Payara Server becomes the main process.

Open ports

Most common default open ports that can be exposed outside of the container:

  • 8080 - HTTP listener
  • 8181 - HTTPS listener
  • 4848 - HTTPS admin listener

Administration

To boot and export admin interface on port 4848 (and also the default HTTP listener on port 8080):

docker run -p 4848:4848 -p 8080:8080 payara/server-full

Because Payara Server doesn't allow insecure remote admin connections (outside of a Docker container), the admin interface is secured by default (in both the default domain1 as well as payaradomain), accessible using HTTPS on the host machine: https://localhost:4848 The default user and password is admin.

Application deployment

Remote deployment

Once admin port is exposed, it is possible to deploy applications remotely, outside of the docker container, by means of admin console and asadmin tool as usual.

Deployment on startup

The docker image supports 2 ways of deploying applications on server startup.

Deployment on startup using a startup script

Since version 172, Payara Server supports running asadmin commands automatically after the domain is started, including the deploy command to deploy applications. This is the preferred way to deploy applications on Docker container startup.

The default Docker entry point will scan the folder $DEPLOY_DIR for files and folders and deploy them automatically after the domain is started.

In order to deploy applications, you can mount the $DEPLOY_DIR (/opt/payara41/deployments) folder as a docker volume to a directory, which contains your applications. The following will run Payara Server in the docker and will start applications that exist in the directory ~/payara/apps on the local file-system:

docker run -p 8080:8080 -v ~/payara/apps:/opt/payara41/deployments payara/server-full

In order to build a Docker image that contains your applications and starts them automatically, you can copy the applications into the $DEPLOY_DIR directory. and run the resulting docker image instead of the original one.

The following example Dockerfile will build an image that starts Payara Server and deploys myapplication.war when the Docker container is started:

FROM payara/server-full

COPY myapplication.war $DEPLOY_DIR

You can now build the Docker image and run the application myapplication.war with the following commands:

docker build -t mycompany/myapplication .
docker run -p 8080:8080 mycompany/myapplication

Deployment on startup using the autodeployment directory

When running the domain1 domain, Payara server automatically deploys all deployable files in the directory specified by the $AUTODEPLOY_DIR environment variable (it refers to the autodeploy directory in the domain directory of domain1).

You can deploy applications in the same way as with the $DEPLOY_DIR directory as described above.

However, deploying applications using the autodeployment directory is discouraged because of many drawbacks:

  • this approach uses only default deployment options, it's not possible to define any deploy parameters, e.g. the context root and more
  • it requires a writable filesystem, what might be cumbersome when deploying from a mounted directory
  • this functionality is disabled in the payaradomain domain for security reasons and has to be enabled before using it with that domain

Selection of domain

The default entry point starts the server in the domain1 domain. If you want to start it with a different domain, e.g. payaradomain, you may provide the domain name in the PAYARA_DOMAIN environment variable. The following would start Payara Server in payaradomain, without changing the entry point:

docker run -p 8080:8080 --env PAYARA_DOMAIN=payaradomain payara/server-full

If you also want to use the AUTODEPLOY_DIR variable (although this is discouraged), you need to overwrite the value of this variable accordingly. It points to the autodeploy directory of the domain1 domain by default.

Details

Payara Server installation is located in the /opt/payara41 directory. This directory is the default working directory of the docker image. The directory name is deliberately free of any versioning so that any scripts written to work with one version can be seamlessly migrated to the latest docker image.

  • Full and Web editions are derived from the OpenJDK 8 images with a Debian Jessie base
  • Micro editions are built on OpenJDK 8 images with an Alpine Linux base to keep image size as small as possible.

Payara Server is a patched, enhanced and supported application server derived from GlassFish Server Open Source Edition 4.x. Visit www.payara.fish for full 24/7 support and lots of free resources.

Full Payara Server and Payara Micro documentation: https://payara.gitbooks.io/payara-server/content/

Docker Pull Command
Owner
payara
Source Repository

Comments (3)
taragona
2 months ago

what is the root password for this container?

rdeni3
8 months ago

Anything special trying to run this on a windows 10 machine? Keep getting errors for the ~/opt*

vzhovtiuk
a year ago

When try to mount domian1/config host directory its has persmiions issues to write it.

Actual exception is java.io.FileNotFoundException: /opt/payara41/glassfish/domains/domain1/config/lockfile (Permission denied)

It seems directories mounted in container as "1001" and process itself running from payara user.