Skip to main content
Skip table of contents

Upgrade Hermod from 2.x to 3.x


Hermod 3.x is based on Spring Boot 2.x, which means that many configuration properties have been renamed or changed. The deployment and configuration are NOT backward compatible with previous versions. The functionality and API of Hermod have however not been changed and are fully backward compatible.

Manual update of the Hermod configuration file IS REQUIRED. Even though many updates are handled inside Hermod 3.x, you might need to change various parts of your configuration, depending on your setup. For general information, see 



The following prerequisites apply: 

  • Hermod is upgraded from 2.x to 3.x. For more information, see Upgrade Hermod.

Step-by-step instruction

  1. Open the Hermod configuration file for editing.
    Default file path: example/compose/hermod/config/cod-hermod.yml.
  2. Update any needed settings according to the following guide: 
    For example: 
    1. Update servlet specific settings, for example the context path: 
      Change from...: 

      Example: Change from...

        contextPath: / 

      Example: Change to...

          context-path: /
    2. If you have configured some settings as start-arguments in docker-compose.yml, make sure to update these, if required. 

    3. If any new spring properties are added, define them in kebab-case.
      Spring 2.x has changed to kebab-case format for all properties. It is however stated that any camelCase properties are backward compatible, but any new properties you configure should be kebab-case to adapt for the future. 
  3. Save the configuration file and restart Hermod. 
  4. Test your new configuration on a non-production server, to make sure it works as expected. 

Contact Nexus

If you need help or have any questions regarding your configuration files, feel free to contact Nexus

JavaScript errors detected

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

If this problem persists, please contact our support.