Upgrade to 2026.2

Vera 2026.2 adds two new Record Integrity services to the stack and reuses the client secret requirements introduced in 2026.1. Follow the steps below to add the new services, configure secrets, then proceed with the database and container upgrades.

If you're upgrading from Vera 2023.4 or earlier, first follow the upgrade instructions for Vera 2024.1.

If you're upgrading from Vera 2024.3 or earlier, first follow the upgrade instructions for Vera 2025.1.

Add the Record Integrity services

Vera 2026.2 introduces vera.api.recordintegrity and vera.worker.recordintegrity to power the new Record Integrity queue. The Auto-fix flow also depends on consumers that ship in the 2026.2 images of vera.worker.jira and vera.worker.qtest.

Roll out the new images for vera.worker.jira and vera.worker.qtest together with vera.worker.recordintegrity. If the Jira or qTest worker is still on an older image, Auto-fix requests for that source system time out.

For deployment steps, see Set up the Record Integrity services.

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.

Enable the GraphQL Console

Vera 2026.2 adds a GraphQL Console and query-engine services for reporting and data export. After you complete the database and container upgrades, deploy the new services and enable the feature flag. For the deployment steps and the Requirements Traceability Matrix template update, check out Enable the GraphQL Console.