Troubleshooting
General Troubleshooting
Timeout error Troubleshooting Guide
6 min
a timeout error in zixi broadcaster indicates that the connection attempt to a target destination has never received a response this is almost always a network or firewall issue the stream is being sent, but something between the sender and receiver is blocking or dropping it before it arrives in the broadcaster the stream status will display "error timeout" and the stream will fail to connect step by step resolution 1\ verify destination address and port check the configuration on the broadcaster side destination address confirm the ip address or hostname is correct and matches the configuration of the target/endpoint destination port confirm the port number matches the configuration on the receiver incorrect information here will cause a timeout confirm the correct values directly with the receiving party 2\ check firewall rules on both sides timeouts are most commonly caused by a firewall dropping traffic you'll need to verify with the network team on both ends that the relevant port is open in both directions sending side outbound traffic on the destination port must be open and permitted receiving side inbound traffic on that same port must be open and permitted many firewalls allow outbound traffic broadly but for security reasons inbound is restricted make sure that both inbound and outbound have been checked not just one if you're using zixi protocol (default ports 2077 & 2088 ) or a custom port, ensure both tcp and/or udp rules are in place as appropriate for your transport type 3\ test general network connectivity before escalating, rule out any broader network issues on the host machine can the machine reach the internet? can it reach the destination ip directly (e g , via ping or traceroute)? is there any vpn, proxy, or routing policy that might be interfering? a successful ping doesn't guarantee the port is open, but a failed ping indicates a possible connectivity problem 4\ escalate to your network team if the above steps haven't resolved the issue, this is likely a network infrastructure problem outside the scope of your zixi software provide your network team with the following the destination ip address and port you're trying to reach the protocol in use (zixi, srt, udp, etc ) the direction of the connection (push vs pull) any firewall rule changes that may have been made recently your network team will be best positioned to trace where the traffic is being blocked troubleshooting decision tree destination address correct? → no → verify ip/hostname with the receiving client & retry destination port correct? → no → confirm port matches the config on the receiver & retry firewall sending side is open? → no → add outbound rule open for the destination port firewall receiving side is open? → no → add inbound rule open for the destination port host machine has internet & network connectivity? → no → ping/traceroute from host to destination test machine can load internet webpages escalated to your local network team? → no → provide team with ip, port, protocol, and direction escalation checklist if all checks passed and the timeout persists then please open a zixi support ticket when escalating to zixi support, you must include as much as possible of the following so that the team may investigate the issue open a support ticket with zixi and include broadcaster version a screenshot or log excerpt showing the timeout error the destination address and port (or confirm they've been verified) any relevant firewall rule screenshots or network topology details
