Share on:

OpenAM Quick Start Guide

Original article:


Install Docker

Install Docker for your platform, if you did not do this before, from

Prepare Hosts File

At first you need to add your to your hosts file aliases - for OpenAm and for Apache Http Server. Your hosts file should contain following line:

OpenAM Configuration

Running OpenAM Image

Create Docker network for OpenAM

docker network create openam-quickstart

Run OpenAM image

docker run -h -p 8080:8080 --network openam-quickstart --name openam openidentityplatform/openam

Basic OpenAM Setup

Open your browser, goto url OpenAM Configuration Start

Click Create Default Configuration.

OpenAM License Agreement

Accept License Agreement

OpenAM Set Passwords

Set password for default admin user and policy agent

Press Create Configuration. After configuration successfully created, press Proceed to Login or open link in browser.

Policy Configuration

OpenAM Console Realm

In administration console select realm, then go to Authorization -> Policy Sets, select Default Policy Set and add new Policy

Set Policy Name as you wish, Resource Type set URL, and add new Resource *://*/* and click Create to save new policy.

OpenAM Console New Policy

On new policy settings select Actions tab and add two actions GET and POST

OpenAM Policy Actions

Then select Subjects tab and set type to Authenticated Users

OpenAM Policy Subjects

Click Save Changes to save your policy

Agent Configuration

Then, in left menu, go to Applications -> Web Agents and create new Agent

OpenAM Web Agents

Set name as you wish, for example apache_agent, set agent password.

OpenAM Create Web Agent

Server URL set

Agent URL set

Click Create to save new Web Agent

Click General tab to return to main menu.

Navigate to Configure -> Global Services -> Platform -> Cookie Domain.

Set cookie domain to, save your settings.

Apache HTTP Server Configuration

Create Dockerfile in your /home/user/openam-quickstart/apache/ folder with following content

FROM httpd:2.4.34


RUN apt-get update || true

RUN apt-get install -y wget unzip

RUN wget --show-progress --progress=bar:force:noscroll --quiet --output-document=/tmp/

RUN unzip /tmp/ -d /usr/

RUN rm /tmp/

RUN echo $PA_PASSWORD > /tmp/pwd.txt

RUN cat /tmp/pwd.txt

RUN cat /etc/issue

RUN /usr/web_agents/apache24_agent/bin/agentadmin --s "/usr/local/apache2/conf/httpd.conf" "" "" "/" "apache_agent" "/tmp/pwd.txt" --acceptLicence --changeOwner

Set ENV PA_PASSWORD as you previously set for your WebAgent in OpenAm

Build Apache Docker image

docker build --network=host -t apache_agent -f /home/user/openam-quickstart/apache/Dockerfile /home/user/openam-quickstart/apache/

And then run image

docker run -it --name apache_agent -p 80:80 -h --shm-size 2G --network openam-quickstart apache_agent

Open in browser link, and you will be redirected to OpenAM Authentication. After authentication you should see default Apache HTTP Server page Apache Default Page