As a first step we will focus on starting Onegini IdP server.


  • text editor
  • docker compose 1.8.0+
  • docker engine 1.12.6+
  • access to Onegini docker hub

Testing the environment

To be sure that your environment is configured properly please follow further steps:

  • check docker version

    $ docker -v
    Docker version 1.12.6, build 78d1802
  • check docker-compose version

    $ docker-compose -v
    docker-compose version 1.8.0, build unknown
  • check access to Onegini docker hub (you should be informed with Login Succeeded)

    $ docker login
    Username: user
    Login Succeeded

Start the application

Onegini IdP is deployed as docker container. To simplify configuration we've created docker compose files that you can get from the Onegini support. Please unzip it on your environment, for this guide we'll use ~/idp directory. You can unzip it with unzip command.

$ unzip ~/Downloads/ -d ~/idp

Provided zip package contains scripts that make starting the application for the first time easy. To do it with basic configuration please execute following commands:

$ cd ~/idp/common/
$ python ./ -v release

The command starts Onegini IdP server along with integration containers like Active Directory, Service Provider, etc. Please note that the start scripts have to be run simultaneously.

Containers need some time to start so please wait few minutes and after that test the application by entering below links: