The Logs tab shows Docker container logs for the Heym stack. Use it for debugging, monitoring, and troubleshooting. For workflow execution logs (node results, outputs), use the Debug panel in the workflow editor—see Canvas Features.
Docker-backed logs are disabled by default in self-hosted deployments. To enable them, set DOCKER_LOGS_ENABLED=true, set DOCKER_LOGS_ALLOWED_EMAILS to a comma-separated list of trusted user emails that are allowed to access Docker logs, and make sure /var/run/docker.sock is mounted into the backend container. The default Docker Compose service and direct docker run example include that mount for Docker-based MCP stdio tools; only keep it when you accept the Docker socket trust boundary.
If registration is open, create the trusted admin account before enabling Docker logs or keep ALLOW_REGISTER=false; otherwise an unverified self-registration could claim an allow-listed email.
Container Selection
- All Containers – Combined logs from backend, frontend, and PostgreSQL
- Backend –
heym-backendcontainer - Frontend –
heym-frontendcontainer - PostgreSQL –
heym-postgrescontainer
Log Level Filter
- All – Show all log levels
- INFO – INFO and above
- WARNING – Warnings and errors
- ERROR – Errors only
- DEBUG – Debug and above
Search
- Filter logs by text search
- Matches are highlighted in the log output
Features
- Auto scroll – Scroll to bottom as new logs arrive
- Stream – Stream logs in real time (when supported)
- Copy – Copy logs to clipboard
- Download – Download logs as a file
Use Cases
- Debug workflow execution failures
- Inspect API request/response logs
- Monitor database queries
- Check startup and health messages
Related
- Canvas Features – Execution logs in the workflow Debug panel
- Traces Tab – LLM trace inspection
- Analytics Tab – Execution metrics
- Workflows Tab – Workflow management
- Contextual Showcase – Compact page guide for dashboard surfaces