Upgrade to 2026.1

Vera 2026.1 requires client secrets to be available as environment variables or Docker secrets before you can run Vera modules as containers. Follow the steps below to configure secrets, then proceed with the database and container upgrades.

Check your upgrade path

Find your current Vera version in the table. A ✓ marks a required intermediate upgrade. Complete each one in order before you upgrade to 2026.1.

Current version	2022.3.3	2023.1.5	2024.1.6	2025.1.4	2025.2.5	2025.3.4
2022.1.x	✓	✓	✓	✓	✓	✓
2022.2.x	✓	✓	✓	✓	✓	✓
2023.2.x			✓	✓	✓	✓
2023.4.x			✓	✓	✓	✓
2024.1.x				✓	✓	✓
2024.2.x				✓	✓	✓
2024.3.x				✓	✓	✓
2025.1.x					✓	✓
2025.2.x					✓	✓
2025.3.x

For upgrade instructions for intermediate versions, follow the upgrade guides for Vera 2024.1 and Vera 2025.1.

Add client secrets as Docker secrets

To add client secrets, follow these steps:

1. Add the following files to your data directory (or a subdirectory):

   • IdentityServer__Secrets__JiraAddOn

   • IdentityServer__Secrets__VeraInternal

   • IdentityServer__Secrets__VeraJiraCloudAddOn

   • IdentityServer__Secrets__VeraSamlClient

   • IdentityServer__Secrets__VeraWebPortal

   • IdentityServer__Secrets__VeraUserInfo

   Set the contents of each file to the secret string. Make sure the web portal and Jira apps are configured with the same values.

2. Update the Docker Compose file. Add the following to each Vera container that requires secrets (all API containers, Vera Server, and some workers):

   Copy

       secrets:
         - IdentityServer__Secrets__JiraAddOn
         - IdentityServer__Secrets__VeraInternal
         - IdentityServer__Secrets__VeraJiraCloudAddOn
         - IdentityServer__Secrets__VeraSamlClient
         - IdentityServer__Secrets__VeraWebPortal
         - IdentityServer__Secrets__VeraUserInfo

3. At the end of the docker-compose.yml file, add or update the secrets element:

   Copy

   secrets:
       vera_internal_secret:
         file: vera_internal_secret.txt
       IdentityServer__Secrets__JiraAddOn:
         file: IdentityServer__Secrets__JiraAddOn
       IdentityServer__Secrets__VeraInternal:
         file: IdentityServer__Secrets__VeraInternal
       IdentityServer__Secrets__VeraJiraCloudAddOn:
         file: IdentityServer__Secrets__VeraJiraCloudAddOn
       IdentityServer__Secrets__VeraSamlClient:
         file: IdentityServer__Secrets__VeraSamlClient
       IdentityServer__Secrets__VeraWebPortal:
         file: IdentityServer__Secrets__VeraWebPortal
       IdentityServer__Secrets__VeraUserInfo:
         file: IdentityServer__Secrets__VeraUserInfo

Complete the upgrade

After you've configured client secrets, proceed with the database and container upgrades:

• Databases – database requirements and MongoDB compatibility.

• Containers – container configurations and microservices.