Common Issues

Below are the most commonly reported issues when running or deploying Prax.

Application Doesn’t Start

Symptom: Terminal hangs or crashes when starting the server.

Checklist:

  • Ensure Node.js ≥ v18 is installed.

  • Delete node_modules and reinstall:

    bashCopyEditrm -rf node_modules && npm install

  • Check .env file is present and correctly formatted.

“Invalid API Key” or LLM Not Responding

Symptom: LLM calls fail or return authorization errors.

Checklist:

  • Make sure the OPENAI_API_KEY is set in .env.

  • Confirm that the model (e.g. gpt-4) is available for your OpenAI account.

  • Verify the backend is restarted after setting the key.

Flows Not Saving

Symptom: Changes in the flow editor are lost after refresh.

Checklist:

  • Ensure the database is connected (SQLite or Postgres).

  • If using Docker, verify volumes are mounted correctly.

  • Confirm write permissions to your local or mounted DB path.

CORS Errors in Frontend

Symptom: API requests from frontend are blocked.

Checklist:

  • Check that FRONTEND_URL and PORT are set correctly.

  • Make sure the backend is accessible via the same host or proxy settings allow CORS.

  • If in Docker, ensure networking between containers is configured properly.

PreviousProduction SetupNextDebug Guide

Last updated