keycloak-scim/README.md

Keycloak Admin Console V2

This project is the next generation of the Keycloak Administration Console. It is written with React and PatternFly 4.

Development Instructions

For development on this project you will need a running Keycloak server listening on port 8180. You will also need yarn installed on your local machine.

1. Start keycloak

   • Download Keycloak server from https://www.keycloak.org/downloads
   • Start Keycloak server like this from the bin directory:

     $> standalone -Djboss.socket.binding.port-offset=100
     

   • or download and run with one command

     $> ./start.js
     

2. Go to the clients section of the exising Keycloak Admin Console and add the client

   • like this:
   • or click on the "Select file" button and import security-admin-console-v2.json

3. Install dependecies and run:

   $> yarn
   $> yarn start
   

Additionally there are some nice scripts to format and lint

$> yarn format
$> yarn lint

To switch to a RH-SSO themed version of this console you can run:

$> npx grunt switch-rh-sso

To switch back just do a git checkout public