# Issues with Local MOSIP Compliance Toolkit Setup

**URL:** <https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117>\
**Category:** Support\
**Created:** [June 19, 2025, 10:00am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117 "2025-06-19T10:00:13Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![wjyang](https://avatars.discourse-cdn.com/v4/letter/w/e9bcb4/32.png) [@wjyang](https://community.mosip.io/u/wjyang)\
**Post date:** [June 19, 2025, 10:00am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/1 "2025-06-19T10:00:13Z")

</div>

I have installed the MOSIP Compliance Toolkit locally.(v1.4.2)

On my test PC, I deployed `mosip-infra V3` (version 1.2.0.2) using RKE.  
The following components have been installed:

- conf-secrets
- config-server
- artifactory
- keymanager
- mock-smtp
- kernel
- masterdata-loader
- biosdk
- pms

I’m currently facing the following three issues and need assistance resolving them:

### 1. Keycloak Initialization Error

While executing `keycloak-init.sh` for the Compliance Toolkit, an error occurred related to the provider `"recaptcha-u-p-form"`.  
To bypass this, I removed the `authentication_flows` section from the `keycloak-init-values.yaml` file.

### 2. Login Page Issue

The login screen of the locally deployed Compliance Toolkit looks different from the one at [https://compliance.synergy.mosip.net](https://compliance.synergy.mosip.net/).  
Specifically, the “Register User” option is missing.  
As a workaround, I manually created a user directly in Keycloak.

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/f/fc8a78b0cfba14ab61ce1aaf32b4c2cb1da660d6.png)

### 3. Missing Template Error After Login

After logging in to the toolkit, I see the following error:  
**`ERROR - Template not found. Upload template and try again!`**  
I followed the instructions in the official documentation under  
[“Steps to upload terms and conditions velocity templates to the Database”](https://docs.mosip.io/compliance-tool-kit/how-to-guides/how-to-set-up-ctk/setup-steps-1.4.0),  
but an error still occurs during the upload process.

---

<div class="post-metadata">

**Author:** ![Varaniya1](https://dub1.discourse-cdn.com/flex017/user_avatar/community.mosip.io/varaniya1/32/1322_2.png) [@Varaniya1](https://community.mosip.io/u/Varaniya1)\
**Post date:** [June 20, 2025, 9:17am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/2 "2025-06-20T09:17:49Z")

</div>

Hi @wjyang,

Thank you for reaching out to us, our team is checking on your issue. Will revert back to you on the same

Regards,  
Varaniya  
Team MOSIP

---

<div class="post-metadata">

**Author:** ![mayuradesh](https://avatars.discourse-cdn.com/v4/letter/m/e19adc/32.png) [@mayuradesh](https://community.mosip.io/u/mayuradesh)\
**Post date:** [June 20, 2025, 10:09am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/3 "2025-06-20T10:09:53Z")

</div>

Hi @wjyang

1 & 3. Do follow [1.4.0 | Compliance Tool Kit](https://docs.mosip.io/compliance-tool-kit/how-to-guides/how-to-set-up-ctk/setup-steps-1.4.0)  
2. In keycloak, you will have to enable “user registration” option under the realm. After that you will get Register User option in the UI.

Hope this helps.  
~ Mayura

---

<div class="post-metadata">

**Author:** ![wjyang](https://avatars.discourse-cdn.com/v4/letter/w/e9bcb4/32.png) [@wjyang](https://community.mosip.io/u/wjyang)\
**Post date:** [June 20, 2025, 11:07am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/4 "2025-06-20T11:07:07Z")

</div>

Hi @Varaniya1 @mayuradesh,

Thank you for your responses to **my question**.

I realized that the version of the Compliance Toolkit I installed was **1.4.1** , not **1.4.2**.  
**Sorry for the confusion.**

* * *

**1. Keycloak Initialization Error**

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/f/f4050b803085277a524c36b6d456ce49039cb5d8.png)

@Varaniya1,  
You mentioned:

> **“1 & 3. Do follow 1.4.0 | Compliance Tool Kit”**

However, I couldn’t find any reference to `"recaptcha-u-p-form"` in the 1.4.0 documentation or configuration.

Did you mean that I should use version **1.4.0** of the Compliance Toolkit instead of 1.4.1?

Thanks in advance!

---

<div class="post-metadata">

**Author:** ![wjyang](https://avatars.discourse-cdn.com/v4/letter/w/e9bcb4/32.png) [@wjyang](https://community.mosip.io/u/wjyang)\
**Post date:** [June 20, 2025, 11:07am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/5 "2025-06-20T11:07:41Z")

</div>

![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/7/7a6c0aa209f23e8677c4cfa3f067fc600739180d.png)

---

<div class="post-metadata">

**Author:** ![wjyang](https://avatars.discourse-cdn.com/v4/letter/w/e9bcb4/32.png) [@wjyang](https://community.mosip.io/u/wjyang)\
**Post date:** [June 20, 2025, 11:08am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/6 "2025-06-20T11:08:13Z")

</div>

![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/0/003727f86cdca66bd0aa81336814661b8b072971.png)

---

<div class="post-metadata">

**Author:** ![mayuradesh](https://avatars.discourse-cdn.com/v4/letter/m/e19adc/32.png) [@mayuradesh](https://community.mosip.io/u/mayuradesh)\
**Post date:** [June 20, 2025, 12:33pm UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/7 "2025-06-20T12:33:43Z")

</div>

Hi @wjyang

Same CTK setup steps documentation as 1.4.0 applies to 1.4.1 and 1.4.2 as well. So you can try with any of these.  
This documentation will not include keycloak setup and hence no reference to “recaptcha-u-p-form” is there in this documentation.

Which image are you running with `toolkit-keycloak-init` job?  
It should be `mosipid/keycloak-init:1.2.0.1`

---

<div class="post-metadata">

**Author:** ![wjyang](https://avatars.discourse-cdn.com/v4/letter/w/e9bcb4/32.png) [@wjyang](https://community.mosip.io/u/wjyang)\
**Post date:** [June 23, 2025, 1:13am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/8 "2025-06-23T01:13:22Z")

</div>

hi @mayuradesh

I used the following `keycloak-init.sh` script:

> <https://github.com/mosip/mosip-compliance-toolkit/blob/v1.4.1/helm/compliance-toolkit/keycloak-init.sh>

If I used the wrong file, I would appreciate it if you could share the correct link.

### 2. Login Page Issue

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/1/138eea776e9d9af51f742ac5c6e0e5ebad5881ad.png)

I confirmed that the **Register** option appeared after applying the following configuration.  
Thank you.

---

<div class="post-metadata">

**Author:** ![wjyang](https://avatars.discourse-cdn.com/v4/letter/w/e9bcb4/32.png) [@wjyang](https://community.mosip.io/u/wjyang)\
**Post date:** [June 23, 2025, 1:14am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/9 "2025-06-23T01:14:40Z")

</div>

![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/8/84abae11fcabc34f957c535d4b98991dba5a5b71.png)

---

<div class="post-metadata">

**Author:** ![mayuradesh](https://avatars.discourse-cdn.com/v4/letter/m/e19adc/32.png) [@mayuradesh](https://community.mosip.io/u/mayuradesh)\
**Post date:** [June 23, 2025, 6:28am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/10 "2025-06-23T06:28:54Z")

</div>

Hi @wjyang

Can you ensure that `mosip-toolkit-client` is created in the realm? You can create it manually too.

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/0/0767850296e03acd75e808c446fe375bd83d2249.png)

In case you are getting errors with the script.  
Hope this helps.

---

<div class="post-metadata">

**Author:** ![wjyang](https://avatars.discourse-cdn.com/v4/letter/w/e9bcb4/32.png) [@wjyang](https://community.mosip.io/u/wjyang)\
**Post date:** [June 23, 2025, 7:39am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/11 "2025-06-23T07:39:26Z")

</div>

hi @mayuradesh

**1. Keycloak Initialization Error**

I was able to run `keycloak-init.sh` and confirm that the Compliance Toolkit is working by removing the `authentication_flows` section from the `keycloak-init-values.yaml` file.

The reason I raised this issue is because the script refers to the `"recaptcha-u-p-form"` flow, which I assumed requires the `recaptcha` provider under **Create Authenticator Execution \> provider** in Keycloak. However, I couldn’t find the `recaptcha` provider in my Keycloak installation.

If the Compliance Toolkit works fine without the `recaptcha` provider, I think I can proceed with testing as is.

Additionally, regarding **3. Missing Template Error After Login** , I was able to verify that it works correctly by following these steps:  
– Add a user role  
– Log in with that user in the Compliance Toolkit UI  
– Follow the instructions in **“Steps to upload terms and conditions velocity templates to the Database”**

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/mosip1/original/2X/2/2bfaf8b56e71ea5611e57e193f0fead0fe3e6ec5.png)

---

<div class="post-metadata">

**Author:** ![mayuradesh](https://avatars.discourse-cdn.com/v4/letter/m/e19adc/32.png) [@mayuradesh](https://community.mosip.io/u/mayuradesh)\
**Post date:** [June 23, 2025, 10:06am UTC](https://community.mosip.io/t/issues-with-local-mosip-compliance-toolkit-setup/2117/12 "2025-06-23T10:06:58Z")

</div>

Happy to hear this @wjyang.

I hope you are able to now work with CTK.
