2020-08-10 17:17:23 +00:00
# Keycloak Admin Console V2
This project is the next generation of the Keycloak Administration Console. It is written with React and PatternFly 4.
2020-08-06 09:31:45 +00:00
2020-08-10 17:17:23 +00:00
### Development Instructions
2020-08-06 09:31:45 +00:00
2020-08-10 17:49:51 +00:00
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. ](https://classic.yarnpkg.com )
2020-08-10 17:17:23 +00:00
1. Start keycloak
* Download Keycloak server from [https://www.keycloak.org/downloads]()
* Start Keycloak server like this from the bin directory:
2020-08-06 09:31:45 +00:00
```bash
2020-08-10 17:17:23 +00:00
$> standalone -Djboss.socket.binding.port-offset=100
2020-08-06 09:31:45 +00:00
```
2020-08-10 17:17:23 +00:00
* or download and run with one command
2020-08-06 09:31:45 +00:00
```bash
$> ./start.js
```
1. Add the client
* like this:
![realm settings ](./realm-settings.png "Realm Settings" )
2020-08-10 17:17:23 +00:00
* or click on the "Select file" button and import `security-admin-console-v2.json`
2020-08-06 09:31:45 +00:00
1. Install dependecies and run:
```bash
$> yarn
2020-09-04 10:38:23 +00:00
$> yarn start
2020-08-06 09:31:45 +00:00
```
### Additionally there are some nice scripts to format and lint
```bash
$> yarn format
$> yarn lint
2020-09-04 10:38:23 +00:00
```
To switch to a RH-SSO themed version of this console you can run:
```bash
$> npx grunt switch-rh-sso
```
To switch back just do a `git checkout public`