Nexus' software components have new names:

Nexus PRIME -> Smart ID Identity Manager
Nexus Certificate Manager -> Smart ID Certificate Manager
Nexus Hybrid Access Gateway -> Smart ID Digital Access component
Nexus Personal -> Smart ID clients

Go to Nexus homepage for overviews of Nexus' solutions, customer cases, news and more.

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.

This article includes updates for Smart ID 22.10.

Related information

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 supported values for the ratio are "input" (default) or "free".


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.