Debugging Overview

Where to start when something goes wrong in TMA Cloud.

Common IssuesCopy Anchor Link

• Common Errors - Frequently encountered errors
• Auth Issues - Authentication problems
• Upload Issues - File upload problems
• Audit Issues - Audit system problems
• Redis Issues - Redis connection problems
• Docker Issues - Docker deployment problems
• OnlyOffice Issues - Document editing problems

Debugging StepsCopy Anchor Link

1. Read the app and worker logs: docker compose logs app worker. Every request line has a request ID, which is also in the X-Request-ID response header
2. Check .env against Environment Variables
3. Check PostgreSQL with pg_isready -d "$DATABASE_URL" and Redis with redis-cli -u "$REDIS_URL" ping
4. Find the error code in Error Codes

Getting HelpCopy Anchor Link

If none of the guides help, open Settings → About, click Copy details, and report the problem with Report issue. See About and Support.

Related TopicsCopy Anchor Link

• Logging - Log levels, formats and request IDs
• Error Codes - Every error code the API returns