Skip to content
Jared Jennings edited this page Dec 12, 2016 · 11 revisions

PWM Requirements

PWM will work on any platform that meets the following minimum requirements:

  • Java J2SE v1.8 or greater.
  • Java Application Server - Java Servlet Container v3.0 (Apache Tomcat v7 or greater).
  • 512 MB of Java heap memory. Heavily utilized sites may require larger heap sizes.
  • 5 GB of disk space for the LocalDB for default configurations. In most cases, the full Java JDK is required to both run and compile PWM. The JRE does not have the neccessary libraries to compile JSP pages. Consult your java application server for more information. PWM does not require a web server.

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

Some administrators may chose to integrate Apache Tomcat with Apache Web Server, Microsoft IIS or other web server, but that is beyond the scope of this document.

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

Windows Installation Instructions:

Windows Installation Instructions Page

Customization

Post change actions to external webservice

Post change actions to external webservice Page