Skip to main content

​
A container does not start

Check docker compose -f docker-compose.prod.yml ps and the relevant service logs. Confirm images can be pulled, mounts exist, and required configuration is present. See production installation.

​
Login fails or redirects to the wrong address

Check externally accessible Keycloak and frontend URLs, TLS and proxy configuration, realm settings, client redirect URIs, and the user’s role.

​
License activation fails

Check the displayed message, key validity, license service connectivity and configuration, and whether the key is already activated elsewhere. Contact the vendor when needed. See Licensing.

​
Provider tests fail

Check endpoint reachability from the container, credentials, model name, provider configuration, and any network policy. Check the relevant document type and workflow stage for overrides.

​
A document is not processed

Confirm the license entitlement, workflow access, workflow configuration, worker status, and provider availability. Review service logs without exposing documents or credentials.

​
A workflow does not export results

Check that verification was completed if required, then verify the export stage, destination, credentials, and permissions.