<< Click to Display Table of Contents >> Raynet One > 2026.1 > Installation and Operations Guide > Raynet One On-Premises Installation and Operations Guide  Troubleshooting

This section covers common issues and their resolution.

 

Required File Not Found or Connection Errors

If initialization containers (e.g., keycloak-init) fail:

 

1. Check Logs

docker logs keycloak-init

 

2. SSL Errors

SSL errors are often caused by missing CA trust when using corporate PKI.

 

•Ensure rootCA.crt is correctly placed and mounted

 

3. Entrypoint Errors

Errors such as "/usr/local/bin/kc-entrypoint: line X: /tmp/kc_realm_init/kc_realm_init: not found" usually indicate a missing file in the container image or a missing volume mount.

 

Network Issues

•Verify all services are attached to internal_net

•Services use Docker DNS internally. For example, from inside server-backend, ping keycloak should resolve and respond