Skip to content

Monitoring and Logs

This guide covers checking Mydia's health, wiring up a Docker health check, and viewing logs.

Health Checks

Mydia exposes a health endpoint:

curl http://localhost:4000/health

Docker Health Check

services:
  mydia:
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:4000/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Logs

View container logs:

docker compose logs -f mydia

Configure log level:

LOG_LEVEL=debug  # or info, warning, error

Background Jobs

Most of what Mydia does on your behalf (scans, metadata refreshes, download monitoring, imports) runs as a background job rather than in a request. When something is not happening and the logs are quiet, Admin > Background Jobs shows the queues, what is running, and what failed.

Next Steps