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 configure the language to be used in Smart ID Identity Manager Admin, Operator and Tenant, and how to add or change translations.


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

To avoid issues when updating, NEVER override the translation files provided within the container. Instead, use separate translation files that only contain the strings you want to modify.

After an update, check your modified translations, and make sure that they or their keys are still valid.

Expand/Collapse All

Step-by-step instructions

Configure supported languages

  1. Open this file for editing: <SMARTIDHOME>/docker/compose/identitymanager/<admin|operator|tenant>/docker-compose.yml.
  2. Set the supported languages and the default language to be used. This is done in the SYSTEM_PROPERTIES environment variable, see Set properties for Identity Manager Operator.


    Default value if not set

    Possible values



    Any value from the list provided in "multilanguageHelper.localeString"



    A comma separated list of valid ISO 639-1 language codes

Modify or add translations

  1. If the container is not running, start it (it does not matter if the container ends up unhealthy and the application does not work, as long as the container is up).

  2. Copy the original files from the container to your host machine. 

    docker cp smartid-idm-<admin|operator|tenant>:/usr/local/tomcat/webapps/ROOT/lang <SMARTIDHOME>/docker/compose/identitymanager/config/translations
  3. Remove the files for the translations you do not support.
  4. Rename the files to have the pattern custom[_<language_code>].properties instead of general[_<lang>].properties.
  5. Add <SMARTIDHOME>/docker/compose/identitymanager/config/translations/custom[_<language_code>].properties as volume to <SMARTIDHOME>/docker/compose/identitymanager/<admin|operator|tenant>/docker-compose.yml.

    - "./config/translations/"
    - "./config/translations/"
  6. (Optional) Run docker-compose up -d to recreate the container, so that the new translation files are loaded.

To modify existing translations, edit your files in <SMARTIDHOME>/docker/compose/identitymanager/config/translations 

  1. In each file, keep only the keys you want to change, and modify their values.

  2. Run docker-compose up -d if you didn't run step 6 in "Extract translation files" above, else run docker-compose restart.

To add a translation file for a language that is not available by default, follow these steps:

  1. Create a new translation file in <SMARTIDHOME>/docker/compose/identitymanager/config/translations/custom[_<language_code>].properties following this naming convention custom[_<language_code>].properties (See ISO 639-1 for a valid list of language codes).

  2. Copy the contents of the extracted into your newly created file in order to have the keys (See "Extract translation files" above for more information).

  3. Edit the file you created and translate the values to your language.

  4. Add the file as volume (see step 5 in "Extract translation files" above).

  5. Run docker-compose up -d so that the container gets the new file.

This article is valid for Smart ID 21.10 and later.

Related information