Skip to main content

Upgrade

Pre-upgrade Checklist​

  • Create full system backup

  • Export all realm configurations

  • Document current settings

  • Test upgrade in staging environment

  • Plan rollback procedure

Upgrade Process​

bash

# 1. Stop Keycloak
./bin/kc.sh stop
# 2. Backup current installation
cp -r keycloak-current keycloak-backup
# 3. Download new version
wget https://github.com/keycloak/keycloak/releases/download/26.2.5/keycloak-26.2.5.tar.gz
# 4. Extract and configure
tar -xzf keycloak-26.2.5.tar.gz
cp -r keycloak-backup/conf keycloak-26.2.5/conf
# 5. Start and verify
./bin/kc.sh start

Post-upgrade Verification​

  • Test authentication flows

  • Verify client integrations

  • Check admin console functionality

  • Monitor logs for errors