Installing Soffid using Docker

• Installing IAM Console
• Installing Sync server

Installing IAM Console

Guide to install IAM Console using Docker. 

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

Prerequisites

• Docker
• 8GB RAM
• > 10GB disk space (50GB recomended)
• Supported database installed

Video Tutorial

Installation

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

Additional parameters to configure the database connections. Allows you to establish the min and the max of database connections: 

The following volumes must be defined by default:

Here you have a sample command to start a docker container running IAM console, in this case the docker will be in a docker network, previously created. MariaDB docker is at the same network.

docker run -d \
   -e DB_URL=jdbc:mariadb://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

When the console is created, the password for the user admin will be changeit and it will be valid for 24 hours.

Now you can connect the Soffid Console http://localhost:8080/soffid/The first thing you must do is to change the admin user password. 

Next Step: Installing Sync server

Installing Sync server

Guide to install Sync server using Docker.

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

Prerequisites

Soffid IAM sync server requires the following requirements:

• Supported database installed
• Soffid Console Installed

Video Tutorial

Linux

Installation

Install first Sync server

To configure the first IAM Sync server, the following environment variables can be set for the first server:

Additional parameters to configure the database connections. Allows you to establish the min and the max of database connections: 

Install next Sync servers

To configure the next sync servers, the following environment variables can be set:

Install Sync server in a private network

To configure a sync server in a private network, not directly accessible from the main sync server, the following environment variables can be set:

You can use this configuration when the main sync server is located in the cloud.

The following volumes are defined by default

Command

Here you have a sample command to start a docker container running IAM sync server. Mind to specify the port number to expose the sync server docker to the outside world. It is not needed when using the cloud connectivity:

docker run -d \
   -e DB_URL=jdbc:mysql://mariadb-service/soffid \
   -e DB_USER=soffid \
   -e DB_PASSWORD=soffid \
   -e SOFFID_PORT=1760 \
   -e SOFFID_HOSTNAME=iam-sync.soffidnet \
   -e SOFFID_MAIN=yes \
   --name=iam-sync \
   --publish 1760:1760 \
   --network=soffidnet \
   soffid/iam-sync:latest

To see sync server log file, execute:

docker logs -f iam-sync

You can also view the log files inside the container. To do this, first enter the container, then you should find the log files in the /var/log/soffid/ directory.

root@soffid:~# docker exec -it iam-sync /bin/bash
root@e1a90ff25d99:/# less /var/log/soffid/syncserver.log

Now you can connect to the IAM console http://localhost:8080/soffid  and chek if Console and Syncserver are connected.