From 5bbf2f9bac9c734fccee2717c3c4dac273618e62 Mon Sep 17 00:00:00 2001
From: gregWDumont <gregory.wd@pm.me>
Date: Thu, 25 Jan 2024 11:35:00 +0100
Subject: [PATCH] add install doc with automation realm client

Signed-off-by: gregWDumont <gregory.wd@pm.me>
---
 README.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 60 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 5068acc..6f0be71 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,73 @@
 # Template Repository
+
 [![License: BSD3](https://img.shields.io/badge/License-BSD3-blue.svg)](https://opensource.org/license/bsd-3-clause/)
 
 [![Trigger Jenkins Pipe](https://github.com/digitharium/hiami-erpnext-keycloak/actions/workflows/main.yml/badge.svg)](https://github.com/digitharium/hiami-erpnext-keycloak/actions/workflows/main.yml)
 
 ## Introduction
+
 This repository is a template for all the repositories that will be used at the hackathon 2024 part of the symposium.
 
 ## Contributors
-* Contributor 1
-* Contributor 2
-* ...
+
+* Pieter-Bas Ijdens [pbijdens](github.com/pbijdens)
+* Romain Kieffer [romainkieffer](github.com/romainkieffer)
+* Grégory Wawszyniak Dumont [gregWDumont](https://github.com/gregWDumont)
 
 ## Instructions
+
 This section will highlight the instructions needed for this repository
 
+### Docker install
+
+Download and install the Docker client from the official [Docker website](https://www.docker.com/).
+
+### Start Keycloak Container
+
+```bash
+docker run -p --name keycloack_container 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak:23.0.4 start-dev
+```
+
+### Clone the frappe_docker Repository and Set Up ERPNext
+
+```bash
+git clone https://github.com/frappe/frappe_docker
+cd frappe_docker
+docker-compose -f pwd.yml up -d
+```
+
+### Set Up ERPNext URI
+
+```bash
+echo "127.0.0.1 erpnext.local" | sudo tee -a /etc/hosts
+```
+
+### Configure Keycloak
+
+Enter the Keycloak container shell:
+
+```bash
+docker exec -it keycloak_container /bin/bash
+```
+
+Inside the container, configure credentials and create a new realm:
+
+```bash
+./kcadm.sh config credentials --server http://localhost:8080/auth --realm master --user admin --password admin
+./kcadm.sh create realms -s realm=newrealm -s enabled=true
+```
+
+Create a client for ERPNext:
+
+```bash
+./kcadm.sh create clients \
+-r newrealm \
+-s clientId=erpnext \
+-s enabled=true \
+-s publicClient=false \
+-s 'redirectUris=["http://erpnext.local/api/method/frappe.integrations.oauth2.authorize"]' \
+-s protocol=openid-connect \
+-s directAccessGrantsEnabled=true \
+-s serviceAccountsEnabled=true \
+-s authorizationServicesEnabled=true 
+```