Skip to content
oretzl edited this page Jul 16, 2021 · 11 revisions

PWM Requirements

=== pwm.war distribution === PWM will work on any platform that meets the following minimum requirements:

  • Java 11 or greater. We recommend AdoptOpenJDK.
  • Java Application Server - Java Servlet Container v3.0 (Apache Tomcat v8 or greater).
  • 512 MB of Java heap memory. Heavily utilized sites may require larger heap sizes up to 1GB.
  • 5 GB of disk space for the LocalDB for default configurations.

PWM is only tested with Apache Tomcat v7 and higher. Other application servers may or may not work.

PWM works with reverse proxy servers, even those that perform URL rewriting.

Some operating systems come equipped with a pre-installed version of Apache Tomcat and Java. Some administrators prefer to use the operating system instance of tomcat while others prefer a standalone tomcat instance for PWM. Keep in mind that the default tomcat settings found on Apache Tomcat downloaded directly from Apache's website are used to test and develop PWM. Conversely, some operating system delivered tomcat configurations can cause problems for PWM.

Installation

Building PWM Password Self Service from Source:

PWM uses Maven to manage packages and dependencies. Maven can also create a war file for deployment

To build the package, execute the mvn package command:

mvn package

The final result will be generated in the sub directory "target". In this directory, you can find the appropriate war file

pwm-1.8.0-SNAPSHOT.war

build Docker images

To build the docker image, execute the mvn package like this:

mvn package -DskipDocker=False

Windows Installation Instructions:

Windows Installation Instructions Page

Customization

Post change actions to external webservice

Post change actions to external webservice Page