# \#upgrading

**URL:** https://forum.keycloak.org/tag/upgrading/74.md

[Latest](https://forum.keycloak.org/latest.md) · [Categories](https://forum.keycloak.org/categories.md) · [Tags](https://forum.keycloak.org/tags.md)

---

## [Keycloak 26.7.1 released](https://forum.keycloak.org/t/keycloak-26-7-1-released/31650)

<div class="topic-metadata">

**Author:** [@hramos](https://forum.keycloak.org/u/hramos)\
**Replies:** 0\
**Last updated:** [August 6, 2026, 10:59am UTC](https://forum.keycloak.org/t/keycloak-26-7-1-released/31650 "2026-08-06T10:59:17Z")

</div>

Link: Keycloak 26.7.1 released - Keycloak

---

## [Keycloak 26.6.0 released](https://forum.keycloak.org/t/keycloak-26-6-0-released/31329)

<div class="topic-metadata">

**Author:** [@hramos](https://forum.keycloak.org/u/hramos)\
**Replies:** 0\
**Last updated:** [April 9, 2026, 9:51am UTC](https://forum.keycloak.org/t/keycloak-26-6-0-released/31329 "2026-04-09T09:51:42Z")

</div>

Link: Keycloak 26.6.0 released - Keycloak

---

## [Keycloak with systemd - Upgrade 26.0.0 to 26.0.x issues](https://forum.keycloak.org/t/keycloak-with-systemd-upgrade-26-0-0-to-26-0-x-issues/28873)

<div class="topic-metadata">

**Author:** [@cwoelkers](https://forum.keycloak.org/u/cwoelkers)\
**Replies:** 3\
**Last updated:** [April 10, 2025, 3:35pm UTC](https://forum.keycloak.org/t/keycloak-with-systemd-upgrade-26-0-0-to-26-0-x-issues/28873 "2025-04-10T15:35:52Z")

</div>

I have been setting up a new server, our first, and have run into an issue using systemd to start keycloak. I started on 26.0.0 a while back and was able to make use of this info on Github to allow systemd to start keycl…

---

## [Upgrade from 15 to 21](https://forum.keycloak.org/t/upgrade-from-15-to-21/22658)

<div class="topic-metadata">

**Author:** [@yeiespi](https://forum.keycloak.org/u/yeiespi)\
**Replies:** 13\
**Last updated:** [February 5, 2025, 2:26pm UTC](https://forum.keycloak.org/t/upgrade-from-15-to-21/22658 "2025-02-05T14:26:19Z")

</div>

Hi, we are planning to upgrade from v15 to v21, any advice? possible problem that we can face? Thanks in advance.

---

## [Upgrade from 14 to 25 fails during Migration](https://forum.keycloak.org/t/upgrade-from-14-to-25-fails-during-migration/28703)

<div class="topic-metadata">

**Author:** [@Suren](https://forum.keycloak.org/u/Suren)\
**Replies:** 2\
**Last updated:** [January 16, 2025, 11:32pm UTC](https://forum.keycloak.org/t/upgrade-from-14-to-25-fails-during-migration/28703 "2025-01-16T23:32:22Z")

</div>

We are upgrading from Keycloak 14 to Keycloak 25.0.6. Our setup contains approximately around 300+ realms. Upgrade stops/fails after approximately 4 min consistently while the migration is going on. I have included fo…

---

## [Migrating to the latest version of keycloak from version 11.0.2](https://forum.keycloak.org/t/migrating-to-the-latest-version-of-keycloak-from-version-11-0-2/29367)

<div class="topic-metadata">

**Author:** [@gerhardvr](https://forum.keycloak.org/u/gerhardvr)\
**Replies:** 3\
**Last updated:** [January 7, 2025, 3:52pm UTC](https://forum.keycloak.org/t/migrating-to-the-latest-version-of-keycloak-from-version-11-0-2/29367 "2025-01-07T15:52:55Z")

</div>

We are going to bite the bullet and upgrade to the latest version. While it would be awesome if the migration of the DB is handled automatically, I’m not too hopeful because of the huge difference in versions. My thinki…

---

## [MySQL error upgrading from 25.0.6 to 26.0.0](https://forum.keycloak.org/t/mysql-error-upgrading-from-25-0-6-to-26-0-0/28427)

<div class="topic-metadata">

**Author:** [@swow](https://forum.keycloak.org/u/swow)\
**Replies:** 15\
**Last updated:** [November 27, 2024, 2:11pm UTC](https://forum.keycloak.org/t/mysql-error-upgrading-from-25-0-6-to-26-0-0/28427 "2024-11-27T14:11:10Z")

</div>

I’m attempting to upgrade my Keycloak from 25.0.6 to 26.0.0. When starting the new version with the config file from the old version, it’s failing to update the MySQL database. To do the update I stopped Keycloak, unzip…

---

## [Keycloak Upgrade Docker Container From 18.0.2 to 21.0.2 With +200 Realms](https://forum.keycloak.org/t/keycloak-upgrade-docker-container-from-18-0-2-to-21-0-2-with-200-realms/26836)

<div class="topic-metadata">

**Author:** [@borisnu](https://forum.keycloak.org/u/borisnu)\
**Replies:** 15\
**Last updated:** [November 10, 2024, 2:17pm UTC](https://forum.keycloak.org/t/keycloak-upgrade-docker-container-from-18-0-2-to-21-0-2-with-200-realms/26836 "2024-11-10T14:17:14Z")

</div>

Hi dear community, I am reaching out to you because we need some community help on upgrading our KC version from 18.0.2 to 21.0.2. We run a multi-tenancy approach where each organisation with users is represented by a re…

---

## [Hostnames not working correctly after upgrading to v25](https://forum.keycloak.org/t/hostnames-not-working-correctly-after-upgrading-to-v25/26549)

<div class="topic-metadata">

**Author:** [@MnemoDes](https://forum.keycloak.org/u/MnemoDes)\
**Replies:** 5\
**Last updated:** [August 28, 2024, 8:15am UTC](https://forum.keycloak.org/t/hostnames-not-working-correctly-after-upgrading-to-v25/26549 "2024-08-28T08:15:37Z")

</div>

We’ve just updgraded to keycloak v25, including all the changes in the configurations files that are specified in the guideline. Since this upgrade, we’ve been having troubles when sending requests to the admin console.…

---

## [Extending FreeMarkerLoginFormsProvider for custom theme attributes](https://forum.keycloak.org/t/extending-freemarkerloginformsprovider-for-custom-theme-attributes/15401)

<div class="topic-metadata">

**Author:** [@cedricguindon](https://forum.keycloak.org/u/cedricguindon)\
**Replies:** 6\
**Last updated:** [July 3, 2024, 2:27pm UTC](https://forum.keycloak.org/t/extending-freemarkerloginformsprovider-for-custom-theme-attributes/15401 "2024-07-03T14:27:20Z")

</div>

Hello I’m currently exploring the upgrade from major 16 to 17 and trying to figure out if it will work with our custom services. After some finagling, i’ve managed to get pretty much everything to work except the follo…

---

## [High CPU Utilization and Frequent Restarts after Upgrading from Keycloak 19 to Keycloak 22](https://forum.keycloak.org/t/high-cpu-utilization-and-frequent-restarts-after-upgrading-from-keycloak-19-to-keycloak-22/26298)

<div class="topic-metadata">

**Author:** [@atulchauhan01](https://forum.keycloak.org/u/atulchauhan01)\
**Replies:** 0\
**Last updated:** [May 30, 2024, 5:19pm UTC](https://forum.keycloak.org/t/high-cpu-utilization-and-frequent-restarts-after-upgrading-from-keycloak-19-to-keycloak-22/26298 "2024-05-30T17:19:51Z")

</div>

We recently upgraded from Keycloak 19 to Keycloak 22 and have observed significant performance degradation in our system. Specifically, CPU utilization has spiked to 90% under normal load. Our setup includes a 2-node clu…

---

## [Lost User and Realm Data After Upgrading Keycloak from 17 to 22](https://forum.keycloak.org/t/lost-user-and-realm-data-after-upgrading-keycloak-from-17-to-22/25276)

<div class="topic-metadata">

**Author:** [@mateusaugusto](https://forum.keycloak.org/u/mateusaugusto)\
**Replies:** 2\
**Last updated:** [March 28, 2024, 12:15pm UTC](https://forum.keycloak.org/t/lost-user-and-realm-data-after-upgrading-keycloak-from-17-to-22/25276 "2024-03-28T12:15:09Z")

</div>

Hello everyone, I’ve recently upgraded Keycloak from version 17 to 22 and encountered a problem where I’m unable to view user and realm data. I’m utilizing Docker Compose with PostgreSQL for my setup. Interestingly, wh…

---

## [Upgrading Keycloak 13 to 23 (Kubernetes)](https://forum.keycloak.org/t/upgrading-keycloak-13-to-23-kubernetes/24206)

<div class="topic-metadata">

**Author:** [@Ranindu](https://forum.keycloak.org/u/Ranindu)\
**Replies:** 5\
**Last updated:** [March 26, 2024, 3:10pm UTC](https://forum.keycloak.org/t/upgrading-keycloak-13-to-23-kubernetes/24206 "2024-03-26T15:10:35Z")

</div>

Hey all, I’m trying to upgrade my keycloak image in my deployment from quay io/keycloak/keycloak:13.0.1 to quay io/keycloak/keycloak:23.0. However, when I push my image to the cluster the pod STATUS changes from comple…

---

## [Upgradation of Keycloak in Kubernetes environment](https://forum.keycloak.org/t/upgradation-of-keycloak-in-kubernetes-environment/25031)

<div class="topic-metadata">

**Author:** [@jahnavisana2812](https://forum.keycloak.org/u/jahnavisana2812)\
**Replies:** 3\
**Last updated:** [March 18, 2024, 12:11pm UTC](https://forum.keycloak.org/t/upgradation-of-keycloak-in-kubernetes-environment/25031 "2024-03-18T12:11:54Z")

</div>

Hey!What are the right steps that are to be followed for the upgradration of keycloak from 22.0.4 to 24.0.1 on kubernetes environment?

---

## [Keycloak upgrade with existing data](https://forum.keycloak.org/t/keycloak-upgrade-with-existing-data/23243)

<div class="topic-metadata">

**Author:** [@r.utilman](https://forum.keycloak.org/u/r.utilman)\
**Replies:** 0\
**Last updated:** [November 6, 2023, 4:18am UTC](https://forum.keycloak.org/t/keycloak-upgrade-with-existing-data/23243 "2023-11-06T04:18:43Z")

</div>

I am trying to upgrade keycloak from 13 to 22. I have the existing db and tried to connect from keycloak 22 on to the database from keycloak 13. I am using mariabd database. I am getting below exception keycloak22 | 2…

---

## [Keycloak 22 upgrade](https://forum.keycloak.org/t/keycloak-22-upgrade/22999)

<div class="topic-metadata">

**Author:** [@r.utilman](https://forum.keycloak.org/u/r.utilman)\
**Replies:** 1\
**Last updated:** [October 20, 2023, 4:11pm UTC](https://forum.keycloak.org/t/keycloak-22-upgrade/22999 "2023-10-20T16:11:47Z")

</div>

Hi, we are planning to upgrade to Keyloak 22 but we are still using older keycloak adapter which is already deprecated. Can we just use latest keycloak without changing any code in the service ? Anyone tried it or does…

---

## [Don't logout users during upgrades](https://forum.keycloak.org/t/dont-logout-users-during-upgrades/22886)

<div class="topic-metadata">

**Author:** [@hehu80](https://forum.keycloak.org/u/hehu80)\
**Replies:** 2\
**Last updated:** [October 17, 2023, 9:20am UTC](https://forum.keycloak.org/t/dont-logout-users-during-upgrades/22886 "2023-10-17T09:20:40Z")

</div>

Hello everyone, in order to prepare an upgrade of our running Keycloak instance (18.x to 21.x) I started reading the upgrading guides. Right at the beginning, I stumbled across the following: In a minor upgrade of Key…

---

## [Upgrading keycloak persist sessions](https://forum.keycloak.org/t/upgrading-keycloak-persist-sessions/22774)

<div class="topic-metadata">

**Author:** [@DonPerinon](https://forum.keycloak.org/u/DonPerinon)\
**Replies:** 0\
**Last updated:** [June 20, 2023, 9:46am UTC](https://forum.keycloak.org/t/upgrading-keycloak-persist-sessions/22774 "2023-06-20T09:46:07Z")

</div>

Hello, I need some advice. I am managing the upgrade of our keycloak 12.0.4 (I know it is a very old version), but I encountered a problem when we have long-term saved sessions and I would need them to remain preserved …

---

## [Issue Upgrading from 18 to 19.0.2 with MSSQL](https://forum.keycloak.org/t/issue-upgrading-from-18-to-19-0-2-with-mssql/17565)

<div class="topic-metadata">

**Author:** [@drp](https://forum.keycloak.org/u/drp)\
**Replies:** 2\
**Last updated:** [April 21, 2023, 11:51am UTC](https://forum.keycloak.org/t/issue-upgrading-from-18-to-19-0-2-with-mssql/17565 "2023-04-21T11:51:24Z")

</div>

Have a server fully working on version 18 using MSSQL database and trying to upgrade to 19.0.2 but it’s getting errors. This is my first upgrade, so tried following the directions, which seem simple enough, but on first…

---

## [Keycloak Upgrade from 15.0.2 to 20.0.2 with old realms and users](https://forum.keycloak.org/t/keycloak-upgrade-from-15-0-2-to-20-0-2-with-old-realms-and-users/19494)

<div class="topic-metadata">

**Author:** [@zunera-aion](https://forum.keycloak.org/u/zunera-aion)\
**Replies:** 1\
**Last updated:** [March 22, 2023, 6:46pm UTC](https://forum.keycloak.org/t/keycloak-upgrade-from-15-0-2-to-20-0-2-with-old-realms-and-users/19494 "2023-03-22T18:46:58Z")

</div>

I have keycloak setup in my Kubernetes environment. It uses image version 15.0.2 and the DB is mssql 15. I want to upgrade the image to 20.0.2. I need to shift the old realms and users within DB to the new schema as wel…

---

## [Unexpected error when handling authentication request to identity provider after upgrade 20](https://forum.keycloak.org/t/unexpected-error-when-handling-authentication-request-to-identity-provider-after-upgrade-20/20862)

<div class="topic-metadata">

**Author:** [@Warlusfag](https://forum.keycloak.org/u/Warlusfag)\
**Replies:** 0\
**Last updated:** [March 15, 2023, 7:29pm UTC](https://forum.keycloak.org/t/unexpected-error-when-handling-authentication-request-to-identity-provider-after-upgrade-20/20862 "2023-03-15T19:29:55Z")

</div>

Hello, I’d like to show this case because I cannot find a solution on my own. I’ve got two keycloak instance 16.1.1 Production and another 20.0.1 Test just upgraded. I was able to upgrade to 20.0.1, some configuration…

---

## [Upgrading 18.0.2 to 19.0.2](https://forum.keycloak.org/t/upgrading-18-0-2-to-19-0-2/17883)

<div class="topic-metadata">

**Author:** [@tomasz](https://forum.keycloak.org/u/tomasz)\
**Replies:** 2\
**Last updated:** [March 10, 2023, 9:56am UTC](https://forum.keycloak.org/t/upgrading-18-0-2-to-19-0-2/17883 "2023-03-10T09:56:15Z")

</div>

Summary: After upgrading Keycloak docker image version from 18.0.2 to 19.0.2 database auto migration does not take place and all the data post upgrade is still present in database but not visible in admin console. Steps…

---

## [Upgrade path for Keycloak from v12 to v21](https://forum.keycloak.org/t/upgrade-path-for-keycloak-from-v12-to-v21/20652)

<div class="topic-metadata">

**Author:** [@jamieyapyq](https://forum.keycloak.org/u/jamieyapyq)\
**Replies:** 0\
**Last updated:** [March 6, 2023, 4:01am UTC](https://forum.keycloak.org/t/upgrade-path-for-keycloak-from-v12-to-v21/20652 "2023-03-06T04:01:56Z")

</div>

Hi,I am trying to upgrade my Keycloak server from 12.0.4 to the newest Keycloak version, using an external postgres database. I understand that there are some migration process to move from old Widlfly distribution to th…

---

## [Upgrading Keycloak from 18.0.0 to 20.0.3 with MySQL](https://forum.keycloak.org/t/upgrading-keycloak-from-18-0-0-to-20-0-3-with-mysql/19937)

<div class="topic-metadata">

**Author:** [@ZZXU99](https://forum.keycloak.org/u/ZZXU99)\
**Replies:** 0\
**Last updated:** [January 30, 2023, 8:02am UTC](https://forum.keycloak.org/t/upgrading-keycloak-from-18-0-0-to-20-0-3-with-mysql/19937 "2023-01-30T08:02:57Z")

</div>

We have issues with our upgrade from 18-20, seems that upgrading to 19 works fine, but when I try with 20.0.3 it fail with this errors, same errors if I create a new empty database. mykeycloak | 2023-01-30 07:45:49,94…

---

## [Question regrading Keycloak upgrade to version 14.0 from Keycloak Server Version 3.2.1.Final](https://forum.keycloak.org/t/question-regrading-keycloak-upgrade-to-version-14-0-from-keycloak-server-version-3-2-1-final/10292)

<div class="topic-metadata">

**Author:** [@vpatel](https://forum.keycloak.org/u/vpatel)\
**Replies:** 2\
**Last updated:** [January 3, 2023, 6:16pm UTC](https://forum.keycloak.org/t/question-regrading-keycloak-upgrade-to-version-14-0-from-keycloak-server-version-3-2-1-final/10292 "2023-01-03T18:16:17Z")

</div>

My company is currently using an older version of Keycloak standalone (3.2.1), at the moment we are making plans to upgrade our installation to Keycloak 14.0. Is there any pointers that you can give me on getting the upg…

---

## [Upgrading Keycloak from 11 to 20 (Docker)](https://forum.keycloak.org/t/upgrading-keycloak-from-11-to-20-docker/18865)

<div class="topic-metadata">

**Author:** [@fouringiz](https://forum.keycloak.org/u/fouringiz)\
**Replies:** 4\
**Last updated:** [December 9, 2022, 12:20pm UTC](https://forum.keycloak.org/t/upgrading-keycloak-from-11-to-20-docker/18865 "2022-12-09T12:20:56Z")

</div>

Hello community planning to upgrade keycloak from 11 to 20 (docker) considering WildFly to Quarkus migration, is it something to be done smoothly or there are caveats? also should it be upgraded 11\>12\>13\>…\>20 or can b…

---

## [Upgrading from keycloak v10.0.2 to New version 20.0.1](https://forum.keycloak.org/t/upgrading-from-keycloak-v10-0-2-to-new-version-20-0-1/18574)

<div class="topic-metadata">

**Author:** [@febriatoz](https://forum.keycloak.org/u/febriatoz)\
**Replies:** 0\
**Last updated:** [November 24, 2022, 10:35am UTC](https://forum.keycloak.org/t/upgrading-from-keycloak-v10-0-2-to-new-version-20-0-1/18574 "2022-11-24T10:35:01Z")

</div>

Hi everyone, Any experience during import realm using command line: PS C:\\Users\\devop\\Documents\\MyWork\\Projects\\Sample\\keycloak-20.0.1\\bin\> ./kc.bat --verbose import --dir “C:\\Users\\devop\\Documents\\MyWork\\Projects\\Samp…

---

## [Upgrade from 15.1 to 16.1.0](https://forum.keycloak.org/t/upgrade-from-15-1-to-16-1-0/13023)

<div class="topic-metadata">

**Author:** [@snadmin](https://forum.keycloak.org/u/snadmin)\
**Replies:** 4\
**Last updated:** [September 9, 2022, 1:36pm UTC](https://forum.keycloak.org/t/upgrade-from-15-1-to-16-1-0/13023 "2022-09-09T13:36:03Z")

</div>

I am upgrading from version 15.1 to 16.1.0. This is a standalone configuration and is using a local MySQL database backend. I went with a fresh copy of the latest 16.1.0 Keycloak tar file and am piece by piece moving con…

---

## [Can you skip major versions when upgrading the Keycloak server?](https://forum.keycloak.org/t/can-you-skip-major-versions-when-upgrading-the-keycloak-server/15115)

<div class="topic-metadata">

**Author:** [@zburkhar](https://forum.keycloak.org/u/zburkhar)\
**Replies:** 1\
**Last updated:** [August 31, 2022, 4:53pm UTC](https://forum.keycloak.org/t/can-you-skip-major-versions-when-upgrading-the-keycloak-server/15115 "2022-08-31T16:53:29Z")

</div>

Hello, Is there a recommendation or best practice when upgrading your Keycloak server in regards to how many versions you skip/what version you upgrade to? We are currently on 11.0.3 and have quickly fallen behind the …

---

## [Keycloak 17.0.1 behind NginX reverse proxy](https://forum.keycloak.org/t/keycloak-17-0-1-behind-nginx-reverse-proxy/15014)

<div class="topic-metadata">

**Author:** [@hoozr](https://forum.keycloak.org/u/hoozr)\
**Replies:** 17\
**Last updated:** [April 25, 2022, 7:06am UTC](https://forum.keycloak.org/t/keycloak-17-0-1-behind-nginx-reverse-proxy/15014 "2022-04-25T07:06:56Z")

</div>

Hello there! I am configuring keycloak in compose like that: keycloak: image: quay.io/keycloak/keycloak:17.0.1 depends\_on: - keycloakdb networks: - net environment: KC\_DB: postgres …

[Next page](https://forum.keycloak.org/tag/upgrading/74.md?match_all_tags=true&page=1&tags%5B%5D=upgrading)
