Skip to main content
Skip table of contents

Configure Self-Service behind a proxy

When running Smart ID Self-Service behind a load balancer or proxy server, some products, such as Apache Web Server or F5, require a custom path in the web application endpoint.

This article describes how to configure Smart ID Self-Service in docker under a custom path (/self_service) for the scenario mentioned above.


In this article, <SMARTIDHOME> refers to /home/nexus, but this can be different depending on the setup.

Step-by-step instruction

Configure context path in Docker-compose.yml

  1. Open this file for editing: <SMARTIDHOME>/docker/compose/selfservice/docker-compose.yml.

  2. Add `-Dspring.jmx.enabled=false` to CATALINA_OPTS. 

    Example: Context path in Docker-compose.yml

    - CATALINA_OPTS=-Djdk.tls.ephemeralDHKeySize=2048 -Dspring.jmx.enabled=false -Xmx512m

Example: Context path in server.xml

  1. Open this file for editing: <SMARTIDHOME>/docker/compose/config/idm-tomcat-server.xml

  2. Add `<Context path="/self_service" docBase="ROOT" />` to the bottom of this file.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.