Troubleshooting

Most reported problems are data or configuration issues, not infrastructure. Start with the health triage, then check the tables below for where users actually get stuck.

The 30-second health triage

curl -fsS http://localhost:3000/api/health   # app: expect database:ok, orchestrator:ok
docker compose ps                            # all services "Up"/healthy?
docker compose logs --tail=100 app           # recent app errors

If /api/health returns 200 with database:ok and orchestrator:ok, the platform is up.

Install / first run

Symptom	Cause / fix
Install seems to hang for many minutes	It’s the one-time model download (several GB). Watch progress with docker compose logs -f python-orchestrator.
GPU device errors on Linux	Install the NVIDIA Container Toolkit, or run with a cloud model provider instead.
Port 3000 already in use	Stop the other service or change the published port in docker-compose.yml.
App loads unstyled	Usually a proxy/cache issue; hard-refresh and check the reverse proxy passes static assets.

License

Symptom	Cause / fix
License won’t activate	Check the key was pasted exactly as emailed, with no extra spaces or line breaks.
“License expired” on a new key	Check the host clock for skew.
Seat limit reached	Expected behavior; raise the tier or remove members.

AI quality & performance

Symptom	Cause / fix
First answer is slow	Model cold start (loading into VRAM); subsequent calls are fast.
Consistently slow	GPU too small for the chosen model; pick a smaller model or a cloud provider for heavy tasks.
“I couldn’t find that in the knowledge base”	Grounding working as intended; add the missing document and retry.
Wrong or stale citations	Re-ingest; newer documents supersede older near-duplicates automatically.

Export

Symptom	Cause / fix
Export button disabled	Export is gated until blocking checklist items (unanswered questions, go/no-go) are complete.
Word/PowerPoint generation fails	Check the orchestrator is healthy: docker compose logs -f python-orchestrator.

Before contacting support

1. Run the health triage above and capture the output.
2. Collect docker compose logs --tail=200 app python-orchestrator.
3. Note the exact action, any error code shown, and whether you’re on local or cloud models.

Still stuck? Email sales@mobiprise.com with the above and we’ll take it from there.