Member-only story
Exploring Keycloak 26: Introducing the Organization Feature for Multi-Tenancy
Introduction
Keycloak 26 introduced a new feature called Organization, which simplifies the management of multi-tenant environments. This post will explain how the Organization feature improves Keycloak’s flexibility in managing multiple tenants, enhancing user management, and strengthening security.
Setting Up Your Project
Prerequisites
- Keycloak 26 version
Step 1: Run Keycloak with enable Organization feature
cd keycloak-26.0.0/bin
./kc.sh start-dev --features organization --http-port=8086
Using docker
docker run --name keycloak -d -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin -p 8086:8080 quay.io/keycloak/keycloak start-dev --features organization
Step 2: Setup Realm
Let’s create a new realm named “demo-realm”.

Step 3: Enable Organization feature
Navigate to the Realm Settings, you will see “Organizations” set to off