Skip to main content
Skip table of contents

Set properties for Smart ID Self-Service

This article includes updates for Smart ID 23.04.

This article describes how to set properties for Smart ID Self-Service.


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

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

  2. Modify the environment variables (See table below for supported variables).
    The prime.baseUrl in APPLICATION_YAML by default uses the variables SMARTID_INGRESS_DOMAIN and IDM_OPERATOR_DOMAIN_PREFIX which you can set in <SMARTIDHOME>/docker/compose/smartid.env.

  3. Restart the Self-Service container.

Environment variable

Default value if not set

Default value in SmartID package



    "prime": {
        "tenantId": 1,
        "instanceId": "selfservice_default_instance"



    "languages": {
        "supportedLanguages": [ "en" ],
        "defaultLanguage": "en"
    "theme": "default",
    "application": {
        "applicationPt1": "Smart ID",
        "applicationPt2": "Self-Service"

    "userPassword": {
        "enabled": true

    "saml": {
        "enabled": true,
        "enforced": false

    "clientCert": {
        "enabled": true,
        "httpsPort": "8444"

    "imagecropper": {
        "selectorVisible": false,
        "ratio": "input" 

The httpsPort depends on the server configuration. This configuration is done in the server.xml file.

The default ratios are "free", "input" (keep aspect ratio), "16:9": and "3:4".

To adjust the choices in the drop-down list for Self-Service users, you can add another line, for example, ratios = [free, "16:9"].


prime.baseUrl in APPLICATION_YAML is mandatory, the container will not start if it is not set.

The default configuration for prime.baseUrl is to go through the ingress domain (public URL). See Configure URLs to other Smart ID components on how to configure this property correctly.

JavaScript errors detected

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

If this problem persists, please contact our support.