Installation on Ubuntu Server 16.04 LTS

Jason Everling edited this page Sep 2, 2018 · 23 revisions

Installing on Linux server is a breeze. This installation guide is specifically for Ubuntu Server 16.04 LTS. But it should work for any recent Ubuntu or Debian based linux installation, make adjustments as needed. Pwm needs a MySql Database or AD to store some settings. This is not covered in this guide

  1. Install the needed packages

    • Install Apache2
      sudo apt-get install -y apache2
    • Install PHP
      sudo apt-get install -y php libapache2-mod-php
  2. Install Tomcat8 & Tomcat8 Tools
    sudo apt-get install -y tomcat8 tomcat8-docs tomcat8-examples tomcat8-admin

    • Add roles and a user to tomcat in order to install .war files trough the browser later on: Edit /etc/tomcat8/tomcat-users.xml and add the following as children of tomcat-users

      <role rolename="manager-gui"/>
      <role rolename="admin-gui"/>
      <role rolename="manager-script"/>
      <user username="username" password="password" roles="manager-gui,admin-gui,manager-script"/>

    • Reboot tomcat for changes to take effect sudo service tomcat8 restart

    • Note: Restarting may take long (couple of minutes for me). You can install haveged entropy gathering daemon to greatly reduce tomcat startup delays, but this is not required: sudo apt-get install -y haveged

  3. Install PWM through your webbrowser

    • Download the latest version from and extract the pwm.war file
    • Go to http://server-ip:8080/manager/html in your browser and login when prompted with the credentials defined in /etc/tomcat8/tomcat-users.xml
    • Use the gui to install the pwm.war file
      • If you have issues issues with this, then you can upload pwm.war to the webapps folder located at /var/lib/tomcat8/webapps/ instead
  4. Create a folder for pwm to store config files and add it's path to pwm.

    • Create a folder somewhere and make 'tomcat8' the owner

      • Example commands if you want to create the folder in /media/pwm/:
        mkdir /media/pwm/
        chown tomcat8 /media/pwm/
    • tell pwm about the newly created folder:

      • edit /etc/default/tomcat8 and add in the top line the below then save it

    • Note: If you rename the war for example to password.war, pwd.war, or idm.war, change PWM_ to your wars name like below

    • Restart tomcat8 for the changes to take effect sudo service tomcat8 restart

  5. Now go to http://server-ip:8080/pwm/

    • Configure pwm
    • I'll update later with more on PWM configuring, for now here is a guide I used but its for 1.7.1 to get PWM up and running with some trial and error.
  6. Test away but when done configuring I highly suggest to secure with a cert! WARNING: Until you secure your site passwords are being sent in the clear!

  7. That's it, enjoy PWM!!

Still a work in progress.......

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.