Capka Troubleshooting
Diagnose Capka from the outside in: server and containers first, then the model connection, then the individual sandbox and task.
The instance does not open
- Confirm the server is running and has free disk space and memory.
- Confirm Docker is active and the Capka containers are healthy.
- Check the reverse proxy, DNS and TLS configuration used for the instance URL.
- Review the installation or update output for the first failing step.
A model does not respond
- Verify the provider key, endpoint URL and selected model name.
- For an OpenAI-compatible endpoint, test that it is reachable from the Capka server.
- For Ollama, confirm the model is loaded and the Ollama endpoint is reachable from the application network.
- Try a small text request before testing a long file workflow.
A sandbox task fails
- Check whether the task exceeded available memory or disk space.
- Confirm sandbox network policy allows any host the task must reach.
- Retry with a small representative file to separate input problems from infrastructure problems.
- Record the release version, reproduction steps and relevant logs before opening a GitHub issue.
Get help
Search existing GitHub Issues before filing a new report. Include the Capka release, server architecture, expected result, actual result and the smallest safe reproduction. Never post API keys, private files or other secrets.