Back to guides

Troubleshooting

Common issues and their solutions when using KorProxy

Quick Fixes

Try these steps first:

  1. Restart the proxy (Dashboard → Stop → Start)
  2. Re-authenticate your provider (Providers → Reconnect)
  3. Check the Logs page for specific error messages
  4. Ensure KorProxy is the latest version

Common Issues

Connection refused (ECONNREFUSED)

The proxy server is not running or not reachable.

  • Make sure KorProxy app is running
  • Check if the proxy is started (green status in dashboard)
  • Verify port 1337 is not blocked by firewall
  • Try restarting the proxy from the dashboard

Invalid API key

The API key validation failed.

  • You can use any string as the API key (e.g., 'korproxy')
  • Verify the base URL is correct (http://localhost:1337)
  • Check that you're using the right endpoint format

Model not found

The specified model is not available.

  • Verify the provider is authenticated in KorProxy
  • Check the model name spelling (case-sensitive)
  • Ensure your subscription supports the requested model
  • See the Models guide for available model names

Session expired / Token expired

Your authentication has expired.

  • Re-authenticate the provider in KorProxy
  • Click the refresh button on the provider card
  • Some providers require periodic re-authentication

Rate limited / Quota exceeded

You've hit the provider's rate limits.

  • Wait a few minutes before retrying
  • Check your subscription tier's limits
  • Consider using a different provider temporarily

Network error / Timeout

The request failed due to network issues.

  • Check your internet connection
  • Verify the provider's API is not experiencing downtime
  • Try a smaller request or different model
  • Check KorProxy logs for detailed error messages

Health States Explained

The dashboard shows the proxy health status:

Healthy

Proxy is running and responding to requests.

Degraded

Proxy is running but experiencing issues. Check logs for details.

Unreachable

Proxy is not responding. It may be starting up or crashed.

Failed

Proxy failed to start. Check logs or restart the app.

Stopped

Proxy is not running. Click Start to begin.

Still Need Help?

If you're still experiencing issues:

  • •Export your logs (Logs → Export) for debugging
  • •Check our GitHub Issues for known problems
  • •Open a new issue with your logs and error details