Troubleshooting

Recovery Procedures

3 min

When things go wrong, follow these recovery procedures. Most issues self-resolve, but knowing the manual steps saves time in production.

Key Points

Buffer empty: wait for automatic recovery once connection resumes
FFmpeg crash: the relay auto-restarts FFmpeg when new chunks arrive
Full system restart: use graceful-stop then restart the stream
Stuck state: check /relay/debug for the full relay state dump