Skip to content

Troubleshooting

ffmpeg Or mp4fragment Not Found

  • Install the required external tools
  • Verify they are on PATH

Health Check Fails

  • confirm the process is running
  • confirm server.bind_addr
  • test curl -i http://localhost:8080/v2/health

Sync Requests Time Out

  • increase sync_timeout_ms in the [server] section of config/service.toml
  • or use async submission and poll GET /v2/jobs/{id}

Request Body Too Large

  • increase max_upload_bytes in the [server] section of config/service.toml

S3 Config Causes Startup Failure

  • build with --features s3
  • verify the configured region, endpoint, and bucket list
  • verify the output buckets are writable at startup

Docs Build Fails

  • in this public documentation repo, run make docs-check
  • in the private implementation repo, run make docs-sync-public to refresh docs/api/openapi.json
  • verify Python can create .venv and install Zensical