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.