17. Twitch Troubleshooting

Troubleshooting issues specific to streaming to Twitch.

17.1 Common Issues

Issue	Description
Transcoding Quality	Stream looks worse on Twitch than expected, poor video quality
Ingest Server Issues	Stream works intermittently, connection failures
Stream Not Appearing	OBS shows streaming but nothing appears on Twitch
Debug Logs	How to check Twitch-specific logs and error messages

Issue: Stream looks worse on Twitch than expected

Check: Verify transcoding settings:

grep TWITCH env/relay.env

Solution: Adjust quality settings:

# Increase bitrate
TWITCH_KBITS_PER_VIDEO_FRAME=100  # From 75

# Better encoding quality (more CPU)
TWITCH_X264_PRESET=slow  # From medium

See Twitch Configuration for detailed settings.

Issue: Stream works sometimes, fails other times

Check: Test different ingest servers:

# Try different endpoints
TWITCH_ENDPOINT=lax  # Los Angeles
TWITCH_ENDPOINT=ord  # Chicago
TWITCH_ENDPOINT=iad  # Ashburn

Verify connectivity:

docker compose exec relay ping -c 5 live-<endpoint>.twitch.tv

Replace <endpoint> with your chosen endpoint (e.g., jfk, lax, ord).

Check: Look at container logs during startup:

docker compose logs relay | grep -i "configured and enabled"

Expected output:

Twitch configured and enabled.

Solution: If Twitch is missing: - Verify TWITCH_KEY is set in env/relay.env - Restart container after setting the key

Check: Look for authentication errors in logs:

docker compose logs relay | grep -i "error\|auth\|publish"

Solution: - Verify stream key is correct in env/relay.env - Check for extra spaces or quotes around key - Get fresh key from Twitch dashboard

For Twitch-specific issues, check logs:

# Twitch-specific logs
docker compose logs relay | grep -i twitch

Success messages:

Twitch configured and enabled.

Error messages:

ERROR: TWITCH_KEY is not set
ERROR: Failed to validate TWITCH_KEY