Troubleshooting

Stream Not Appearing in Unleash live

1. Check stream status to ensure status is running:

unleash-stream-cli list

2. Follow logs for the relevant stream:

unleash-stream-cli logs DEVICE -f

3. Verify the source URL is accessible from the machine.
4. Verify the destination URL (device ID + token) is correct.

Stream Repeatedly Fails

• Check the FFmpeg log file for error details.
• Confirm RTSP credentials and source URL correctness.
• Confirm outbound RTMP/network access is not blocked.
• Increase connection timeout (--timeout) for slow sources:

Service Not Running

macOS

launchctl list | grep unleash

Linux (systemd)

systemctl --user status unleash-stream.service

Check service logs

cat /tmp/unleash-stream-service.log

macOS Camera Permissions

macOS requires explicit camera permission for background capture processes.

Go to System Settings > Privacy & Security > Camera and ensure access is allowed for unleash-stream-cli.

Support

If the issue persists, contact Unleash live Support or your Unleash live Account Manager.