From arch-announce at lists.archlinux.org  Fri Mar 25 14:25:57 2022
From: arch-announce at lists.archlinux.org (Arch Linux: Recent news updates: Leonidas Spyropoulos)
Date: Fri, 25 Mar 2022 14:25:57 -0000
Subject: [arch-announce] Keycloak 17.0.1-2 update requires manual
 reconfiguration
Message-ID: <164821835765.410.5308563782542382304@archlinux.org>

The `keycloak` package prior to version 17.0.1-2 was running with WildFly server. Since upstream officially moved to [Quarkus distribution](https://www.keycloak.org/2020/12/first-keycloak-x-release.adoc), Arch Linux follows this approach. This means some manual intervention is required for the upgrade.

The configuration needs to be adjusted from the old `.xml` format to the new `/etc/keycloak/keycloak.conf`.

Prior to the upgrade, stop the keycloak service, upgrade the package and migrate the configuration before starting:

    systemctl stop keycloak.service
    pacman -Syu keycloak
    # migrate configuration /etc/keycloak/keycloak.conf
    systemctl start keycloak.service


See Keycloak [migration docs](https://www.keycloak.org/migration/migrating-to-quarkus) and Keycloak Quarkus [server docs](https://www.keycloak.org/server/configuration)

URL: https://archlinux.org/news/keycloak-1701-2-update-requires-manual-reconfiguration/