Operations

Health and logs

Check the process, container and events that help diagnose problems.

Health route

GET /health

Compose calls this route from inside the container at http://localhost:2507/health.

Docker

docker compose ps
docker compose logs --tail 200 tradoc

Development

The supervisor displays Uvicorn and Vite separately. HTTP status codes are useful:

  • 200: request accepted;
  • 400: rejected document or value;
  • 403: forbidden origin or operation;
  • 409: incompatible project state;
  • 422: parameter outside allowed limits;
  • 500: reconstruction or internal error to investigate.

Logs and secrets

Before sharing logs, remove keys, private URLs, confidential file names and manuscript excerpts. Never publish .env or provider_credentials.json.

Public demo

Security boundary and differences between the static demo and self-hosted product.

Troubleshooting

Resolve port, provider, import, progress and export problems.