Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk4 min

Customizing Keycloak: Themes, Login Flows, and Disabled-User Handling

A practical guide to Keycloak theme inheritance, authentication-flow design, broker onboarding controls and what they do—and do not—say about disabled accounts.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keycloak customization covers the login, Admin and Account Consoles, and authentication journeys. Extend a bundled theme and override only what you need; design login flows by reviewing their hierarchy, executions and requirements together. Be careful with the phrase “disabled user”: preventing a broker flow from creating a new account is not the same as disabling an existing account.

What can you customize in Keycloak?

Keycloak supports customization across multiple interfaces, including the login page, Admin Console and Account Console. The theme type you select should match the interface you intend to change. See Keycloak’s introduction to UI customization for the available areas.

As an Amazon Associate I earn from qualifying purchases.

Themes can include HTML templates, images, message bundles, stylesheets, scripts and theme properties. Keycloak renders HTML with FreeMarker templates. For most changes, inherit from a bundled theme and selectively override resources rather than replacing broad sets of templates.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How to build and deploy a custom theme

  1. Create a custom theme directory under the server’s themes directory, with a directory for each theme type you plan to customize.

    #1 Best Overall
    Tecmojo 12U Open Frame Network Rack for IT & AV Gear, AV Rack Floor Standing or Wall Mounted,with 2 PCS 1U Rack Shelves & Mounting Hardware,Network Rack for 19" Networking,Audio and Video Device
    • 【Powerful Load-bearing】12U Network Rack Open Frame is constructed from durable cold rolled steel; Rack shelf supports enhance stability, wall-mounted capacity of 130lbs, the ground-mounted up to 260lbs
    • 【Considerate Designs】Open-frame layout, including a top panel adding space, anti-slip shelf stops fixing devices and compatible racks for stack and expansion to meet requirements of home server rack
    • 【Complete Accessories】A 12U open frame server rack, two ventilated shelves, four shelf stops, four velcro straps and a set of equipment mounting screws
    • 【Versatile Application】Ideal for space-efficient multi-device setups in warehouses, retail, classrooms, offices and more; Excellent choices as AV Rack/IT Rack
    • 【Effortless Setup】 Network Rack includes hardware, a comprehensive manual, mounting hole drilling template and an online assembly video to simplify setup
  2. Add a theme.properties file for each type. Specify the parent theme and any imported resources the theme needs.

  3. During development, disable theme and template caching so edits are easier to inspect. Once the theme is ready, re-enable caching in production. Keycloak warns that caching has a significant effect on performance.

  4. In the Admin Console, open Realm Settings > Themes and select the custom theme for the relevant theme type.

    What’s actually slowing this PC down?

    Pick the symptom - the matching free tool is one click away.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
    Rank #2
    Sale
    StarTech 42U 4-Post Open Frame Rack, 19in, 22-40in, 1323lb/600kg
    • ADJUSTABLE DEPTH: 4-Post 42U open frame server rack with 4 vertical rails and adjustable mounting depth 22" to 40" (56,0cm to 101,7cm); Compatible with various servers / switches / data / AV and other IT equipment; EIA/ECA-310-E Compliant
    • EASY ASSEMBLY: Mobile network rack with easy-to-follow assembly instructions and online video; Compact flat-pack shipping to avoid damage and facilitate installation; Total product height of 80.3in (204 cm) with casters, 78in (198cm) without casters
    • COLD ROLLED STEEL: Durable 4 Post 19in open frame rack designed for ventilation with 42U mounting height and 1320lb (600kg) weight capacity (stationary); 3 install options included: casters, levelling feet, or base-plate to secure rack to the floor
    • HARDWARE INCLUDED: Rolling computer/data rack includes cage nuts and screws to mount equipment, easy to read Units (U) and depth adjustment markings, cable management hooks for organization, and required assembly tools
    • THE IT PRO'S CHOICE: Designed and built for IT Professionals, this 42U rack is backed for 2-years, including free lifetime 24/5 multi-lingual technical assistance
  5. Keep changes focused. Avoid editing bundled theme files directly; targeted overrides are easier to maintain across upgrades.

Custom templates require particular care during upgrades: compare each override with the corresponding template in the version-matched Keycloak release and update it as needed. A template can also have security implications. Keycloak notes that a malicious FreeMarker template can run code as the Keycloak process, so limit write access to theme directories and theme JARs to trusted operators. See the Keycloak theme guide for theme composition, caching and security guidance.

How to design an authentication flow

Authentication flows are configured in the Admin Console’s Authentication area. In Keycloak Server Administration Guide 26.8.0, flow behavior is determined by three factors: the flow and subflow hierarchy, the executions within each level, and the requirement assigned to each execution and subflow. These controls work together; changing one without reviewing the others can change which paths run or whether a flow completes.

Rank #3
Sale
TECMOJO 12U Open Frame Network Rack for IT & AV Gear, 4-Post With Casters, Mobile With 2 PCS 1U Server Shelf & Mounting Hardware, for 19" Network, Audio and Video Device
  • 【Powerful load-bearing】12U Network Rack Open Frame is constructed from durable Cold Rolled Steel; Rack Shelf Back Support enhances stability; load-bearing capacity of 260lbs
  • 【Sliding&Considerate】Open-frame layout, including four wheels easy to move, a top panel adding space, anti-slip shelf stops fixing devices and compatible racks for stack and expansion to meet requirements of home server rack
  • 【Complete Accessories】A 12U open frame server rack, two ventilated shelves, four shelf stops, four casters, four velcro straps and a set of equipment mounting screws
  • 【Versatile Application】Ideal for space-efficient multi-device setups in warehouses, retail, classrooms, offices and more; Excellent choices as AV Rack/IT Rack
  • 【Effortless Setup】Server rack with wheels includes hardware, a comprehensive manual, mounting hole drilling template and an online assembly video to simplify setup

Adapt an existing flow

The guide supports duplicating an existing flow and modifying the copy. This is often a maintainable starting point when the desired behavior is close to a built-in journey. Inspect the copied hierarchy and requirements rather than assuming the original configuration remains suitable for the new purpose.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Create a flow for different behavior

A new flow starts with a top-level flow definition, to which you add executions and subflows. Executions may run automatically or pause for interactive user input. Before production, test intended paths, alternative branches and failure cases in an environment that matches the deployed Keycloak version.

Use custom Authenticators when needed

Developers can implement custom Authenticators for specialized behavior and incorporate them into a flow. This adds development and maintenance responsibilities alongside security review; it is not just a console configuration change.

Rank #4
VEVOR 12U Open Frame Server Rack, 23-40 in Adjustable Depth, Free Standing or Wall Mount Network Server Rack, 4 Post AV Rack with Casters, Holds All Your Networking IT Equipment AV Gear Router Modem
  • Adjustable Depth: 23-40'' adjustable depth is used for servers and network equipment, ensuring enough space for AV equipment, components, and cabling, while allowing you to access ports and equipment from multiple sides.
  • Strong Load Capacity: Ground-Mounted Load Capacity: 500 lbs, Wall-Mounted Load Capacity: 150 lbs. The av rack is made of carbon steel for better weldability performance and can help save space while meeting your need to place multiple devices.
  • User-friendly Design: Ergonomic design makes the open frame av rack easier to use. The additional top panel is able to place other items with more available space. Roller design moves anywhere and anytime, is convenient, and is more energy-saving.
  • Complete Accessories: We provide the accessories you need, including 2 x Pallets, 145 x M5*10 Cross Head Screws, 4 x Casters, 4 x M10*50 Expansion Screws,10 x M6*12 Cage Nuts, 1 x Grounding Wire, 1 x User Manual.
  • Wide Application: The server rack wall mount maximizes the use of available space, suitable for retail venues, classrooms, offices, and other places where space is limited.

Distinguish first-login and post-login broker flows

Identity-provider settings distinguish First Login Flow, used when a user first logs in through that provider, from Post Login Flow, which can run additional actions after provider login. The distinction matters when configuring broker onboarding; neither setting is a general control for disabling an existing Keycloak account. The versioned Keycloak Server Administration Guide 26.8.0 documents flow configuration and broker behavior.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Does preventing account creation disable an existing user?

No. The broker-flow settings described in the administration guide concern automatic creation of a local account when someone arrives through an external identity provider and no matching account exists. They do not establish how to disable a user account that already exists.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Prevent automatic creation during first broker login

For deployments where users are pre-created, such as a read-only LDAP store, the guide describes disabling both Create User If Unique and Confirm Link Existing Account by setting their requirements to DISABLED in the First Broker Login flow. The guide says this is independent of the realm’s self-registration switch. This changes broker onboarding behavior; it is not an account-disable operation.

Constrain broker login to existing users

The guide also describes a first-login design using Detect Existing Broker User and Automatically Set Existing User, both with requirements set to REQUIRED. Configure the identity provider to use that First Login Flow. Automatically associating a broker login with an existing account is a trust and account-linking decision; assess the identity provider and matching behavior carefully before using it.

For an existing disabled account, verify the deployed version

The procedures above do not establish the exact user-level steps for disabling an existing account, the message that user sees at login, or whether existing sessions end. They also do not establish behavior for every user-federation provider. Consult the user-management and REST API documentation matching your deployed Keycloak version before making those changes or relying on session effects.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.