> ## Documentation Index
> Fetch the complete documentation index at: https://docs.welesai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Troubleshoot common Weles problems: containers that do not start, login and redirect failures, AI provider errors, and workflow issues.

## 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](https://docs.welesai.com/quickstart.md).

## 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](https://docs.welesai.com/administration/licensing.md).

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.