Troubleshooting

Server does not start

• Confirm SECRET_KEY is set.
• Verify Postgres credentials when using production mode.
• Review logs for migration errors.

Health check returns error

• Check database connectivity.
• Ensure migrations completed.

Email not sending

• Verify SMTP settings in .env.
• Send a test email from the admin panel.

WebSocket connects but no sync

• Confirm the user is a project owner or collaborator.
• Ensure cookies are present for /yjs requests.

Link preview fails

• URL may be blocked by SSRF protection.
• Check outbound network access from the container.

File upload fails

• Verify storage volume permissions.
• Ensure uploads are sent as multipart form data with file.