Troubleshooting
| Issue | Solution |
|---|---|
| Misconfigured Application - Reinstallation Required | 1. Navigate to the datafocus folder:> cd datafocus2. Shut down and remove all services: > docker compose down -v3. Delete the entire datafocus folder.To clean up the entire Docker environment (optional): > docker system prune -af |
| Cannot Access User Interface / CORS Errors | If you cannot reach the user interface or encounter CORS errors: 1. Restart the router container: > docker compose restart router2. Verify the hostname configuration as described in Hostname Configuration. 3. Ensure ports 80 and 443 are open on the server. |
| "Compose" is Not a Docker Command | If you encounter the error compose is not a docker command: This likely indicates that Docker Compose is not properly installed or configured. Revisit the installation steps to ensure Docker Compose is correctly set up on your system. |
| Invalid Parameter: redirect_uri | If you receive an Invalid Parameter: redirect_uri error: 1. Double-check the configurations outlined in Keycloak Configuration. 2. Verify that the Root URL and Valid Redirect URIs are properly set according to your hostname. |
| Kafka: Message Size Too Large ([Error 10] MessageSizeTooLargeError) | If you see this error in the frontend or logs, the message exceeds Kafka limits. 1. Increase the broker limit in docker-compose.yml by raising the environment variable in the Kafka service: KAFKA_MESSAGE_MAX_BYTES: 5242880 → set to a higher value (e.g., 10485760 for 10 MB or 20971520 for 20 MB). 2. Apply changes: docker compose up -d |