Tools

TURN server test

Check that a STUN or TURN server answers, that it accepts your credentials and that data really passes through its relay. The test runs in your browser, so it sees what the browsers of your users see.

Your browser talks straight to the servers you enter. Your addresses and credentials are not sent to us or kept.

Using WordPlus Cloud? Test the connection to our servers.

Step by step: How to test a TURN server: does it answer, log in and relay?

Reading the results

What each result means

A public address came back

A STUN server answered and told the browser how the internet sees it. A call can use that address to try a direct path.

A relay address came back

A TURN server accepted your credentials and opened a relay for this browser. That address is where the other person would send data.

Data passed through the relay

The test sent messages from this browser through the relay and back, and shows the round trip. This is what a call needs, and it is the step a server with closed relay ports fails.

The credentials were refused

The server answered but did not accept the username or credential, or they have expired. This is error 401 or 441.

The server could not be reached

Nothing answered at that address, port and protocol, usually because of a wrong port or a firewall on either side. This is error 701.

An address came back but no data passed

The server answers on its main port, but its relay ports are closed, or it refuses to relay to itself. Calls through it may fail even though it looks healthy.

Test every way in

UDP is the fastest path, but some networks allow only web traffic. Give your calls TURN over UDP, over TCP and over TLS on port 443, and test each address on its own line.

Addresses to test
stun:turn.example.com:3478
turn:turn.example.com:3478?transport=udp
turn:turn.example.com:3478?transport=tcp
turns:turn.example.com:443?transport=tcp

WordPlus Cloud

Rather not run a TURN server?

Calls on WordPlus Cloud use our relays in regions around the world, and each device reaches the nearest one. Relays are never charged, and there is nothing for you to host.

Questions

Frequently asked

How do I test a TURN server?

Enter its address, username and credential, then run the test. A relay address means the server accepted the credentials and gave the browser a relay. The test then sends data through that relay and back, which also shows that the relay ports are open.

Can I test a TURN server without credentials?

Yes, as far as reaching it. Leave the username and credential empty, and the test logs in with details that are not valid. The server refuses them, and that answer shows this way in is open. Testing the relay itself takes real ones.

What is the difference between testing STUN and testing TURN?

A STUN server only tells the browser its public address, so that test passes when the address comes back, with no credentials. A TURN server carries the call itself, so it needs credentials, and its test passes when data goes through it.

What does error 701 mean?

The browser could not reach the server at that address, port and protocol. Check the name, the port and the firewall on the server, then the network you are on. Some networks block port 3478, so offer port 443 too. Chrome can also report 701 for one network interface while another works, so this test counts it only when no address comes back.

What does error 401 mean?

The server answered but refused the username or credential. Time-limited credentials fail the same way once they expire, so make a new pair and test again.

Why does the server give a relay address but no data pass?

The server answers on its main port, but the relay uses a range of other ports, often 49152 to 65535. When a firewall closes them, the address comes back and calls still fail. A server behind NAT also needs its public address set. Some servers refuse to relay to their own address, which fails this step while real calls may work, so try a call between two networks before changing anything.

Do my credentials reach WordPlus?

No. The test runs in your browser, which talks straight to the server you entered. Nothing you type is sent to us or kept. Short-lived credentials are still the better thing to test with.

If the test passes, will calls work for all my users?

It shows that this browser on this network gets through. Someone on a stricter network may not, so test TURN over UDP, over TCP and over TLS on port 443, and from the networks your users are on.

Do I need to run my own TURN server?

Not if your calls run on WordPlus Cloud. Our relays run in regions around the world and each device reaches the nearest one, with nothing for you to host.