Skip to main content

Upgrading Ory Hydra OEL

This document provides a comprehensive guide on how to upgrade your Ory Hydra Enterprise License (OEL) version. Upgrading to the latest version ensures you have the newest features, security updates, and performance improvements.

Prerequisites

Before proceeding with the upgrade, ensure you have:

  • A valid Ory Enterprise License.
  • Access to the Ory Enterprise Docker Registry.
  • Backup of your current data and configuration.

Pick the right version

To upgrade Ory Hydra OEL, you need to know the version you are currently running. Check your Docker or Kubernetes environment to find the tag. You should find your tag in this list:

Image TagRelease Date
897e224960bb8677edf3344bd51c9edd779e9da72024-06-05
f2ead7db68e8af72dbd1ab099fbaa6bf0f0ec8c32024-06-12
39bbe4e0d99d40d5c4feb97321fc68b20f02a7ae2024-06-14
f066fc62fc37ee1d28b4f2973faaa2bc098fc9522024-06-18
f832e165e187e49657229902c13ad30c4cf10d0b2024-06-20
1578667fa246c374ca85c5eadbf49cc53a2967752024-06-26
73a77968be31cbcba18b02918a8c11343a1fa0382024-07-04
470aebc3ab2d4c225ca14ab8b1a12809f51b7eb32024-07-18
0fd87c560867f19ab12276edf258e42c4688454a2024-07-24
04858989138f4b09c2b9b9676e3641326d96b1a62024-08-02
1f407d0b2035e50812e6888a71b772530d17fc7a2024-08-12
9b96c2507f9f17f639f73c2a9284f32bf63cd9d82024-08-27
bf4441cc6dc1f8e8387173ae8f1396395dc1f4332024-08-30
note

Zero-downtime migrations are only possible if you do not skip any version when upgrading.

The tags are ordered by date. To upgrade, you need to pick the next version in the list.

Upgrade Using Helm Charts in Kubernetes

Upgrading Ory Hydra OEL in Kubernetes is straightforward when using Ory's Helm Charts. Follow these steps to upgrade Ory Hydra OEL:

1. Enable auto SQL migration

Set hydra.automigration.enabled to true in the values.yaml file:

image:
# ....
# ...
hydra:
automigration:
enabled: true
# ...

2. Update the image tag

image:
repository: europe-docker.pkg.dev/ory-artifacts/ory-enterprise/hydra-oel
tag: <replace-with-current-image-tag>
# ...

3. Apply / install the helm chart

You can now apply the upgrade:

helm upgrade ory-oel-hydra ory/hydra --namespace ory -f values.yaml

4. Wait for the upgrade to propagate

Once the init container is done and the main container is running, the upgrade is complete.

Upgrade steps without Helm Charts

1. Check Release Notes

Before upgrading, review the changelog for the new version to understand the changes, new features, and any deprecations.

2. Backup Your Data

Ensure you have a complete backup of your database and configuration files. This step is crucial for restoring your system in case of an upgrade failure.

3. Pull the Latest Docker Image

Pull the latest Ory Hydra OEL Docker image from the Ory Enterprise Docker Registry:

docker pull europe-docker.pkg.dev/ory-artifacts/ory-enterprise/hydra-oel:<new-version-tag>

5. Apply SQL Migrations

Before deploying the service, you need to apply SQL migrations:

docker run \
-e DSN=your_database_connection_string \
europe-docker.pkg.dev/ory-artifacts/ory-enterprise/hydra-oel:<new-version-tag> \
-- migrate sql -e -f /path/to/config.yaml

Replace your_database_connection_string with your actual database connection string.

5. Stop the Service

Once done, you can stop the processes running the old service.

6. Start the Service

Now you will be able to start the service:

docker run \
-p 4444:4444 -p 4445:4445 \
-e DSN=your_database_connection_string \
europe-docker.pkg.dev/ory-artifacts/ory-enterprise/hydra-oel:<new-version-tag> \
-- serve all -f /path/to/config.yaml

Replace your_database_connection_string with your actual database connection string.

Conclusion

Upgrading Ory Hydra OEL is essential to keep your system secure and up-to-date. By following the steps outlined in this guide, you can ensure a smooth upgrade process with minimal downtime.

If you encounter any issues during the upgrade process, please reach out to the Ory support team for assistance.