Installing IAM Console

1. Introduction

Guide to install IAM Console using Docker.

There is a public docker image at docker hub: https://hub.docker.com/r/soffid/iam-console/

2. Prerequisites

To install IAM console is required to have a database installed and initialized. You can check Initialize database

Supported databases are:

Maria DB
MySQL
PostgreSQL
Oracle
MS SqlServer

3. Video Tutorial

4. Installation

To configure IAM console, the following environment variables can be set:

Variable	Description	Example
DB_URL	JDBC URL	jdbc:mariadb://dbcontainer/soffid
DB_USER	Database user	Soffid
DB_PASSWORD	Database password	5uper5ecret
JAVA_OPT	Java virtual machine options	-Xmx4096m
SECURE	(optional) Enables the Java Security Manager	true

The following volumes are defined by default:

Volume	Usage
/opt/soffid/iam-console-3/logs	Console log files
/opt/soffid/iam-console-3/docs	Text search engine index files. It can be erased at any time. The engine will regenerate the search engine
/opt/soffid/iam-console-3/conf	Configuration files, including server.xml and tomee.xml files

Here you have a sample command to start a docker container running IAM console

docker run -d \
   -e DB_URL=jdbc:mysql://mariadb-service/soffid \
   -e DB_USER=soffid \
   -e DB_PASSWORD=soffid \
   --name=iam-console \
   --publish=8080:8080 \
   --network=soffidnet \
   soffid/iam-console

To see console log files, execute:

docker logs -f iam-console

By default, the 8080 port will be exposed. When the TLS connection is going to be configured, add the tag --publish=443:443 to publisg the TLS port.