Skip to content

Troubleshooting ​

Checks shared by whipinto, whepfrom and the probe tools. Start with -vv: the WebRTC and bridge diagnostics normally show which stage failed.

Authentication and HTTP status ​

SymptomWhat to check
401 UnauthorizedPass -t <token> and make sure it exactly matches the server's [auth] tokens; do not add a second Bearer prefix.
403 ForbiddenAuthentication reached the server but a proxy or cluster policy rejected it; check Live777/liveman authorization and routing rules.
409 ConflictA publisher, session or configured source already owns the stream. Stop it, use another stream, or review strategy.override_publisher; cascade-pull publishers cannot be displaced.
503 Service UnavailableThe cluster has no available node with remaining subscriber capacity; check node health, capacity limits and scheduling policy.

A 404 means the endpoint path itself is wrong (/whip/<stream> versus /whep/<stream>), the stream is missing under a policy that disables automatic creation, or a reverse proxy is rewriting the path. Each tool page lists what it expects.

ICE timeout or disconnected ​

Host candidates alone only work where the client and the server can reach each other directly. For remote or NAT deployments, configure server ICE addresses and STUN/TURN, then pass --ice-server when the client needs it. See live777 configuration.

Connected, but no media ​

Confirm the upstream direction is actually producing media: a publisher is attached for a subscriber, the sender emits to the SDP ports, and the SDP codecs match the encoder output. If the tool reports frames decoded but the receiver shows nothing, the problem is downstream of Live777 — check the receiver's SDP and firewall rules.

Released under the MPL-2.0 License.