Skip to content

Commit 56f81fc

Browse files
committed
document STUN warnings
1 parent 6f04178 commit 56f81fc

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

docs/admin/healthcheck.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -170,6 +170,31 @@ curl -v "https://coder.company.com/derp"
170170
# DERP requires connection upgrade
171171
```
172172

173+
### ESTUN01
174+
175+
_No STUN nodes available._
176+
177+
**Problem:** This is shown if no STUN-capable nodes are available. Coder will
178+
use STUN to establish [direct connections](../networking/stun.md). Without at
179+
least one working STUN server, direct connections may not be possible.
180+
181+
**Solution:** Ensure that the
182+
[configured STUN severs](../cli/server.md#derp-server-stun-addresses) are
183+
reachable from Coder and that UDP traffic can be sent/received on the configured
184+
port.
185+
186+
### ESTUN02
187+
188+
_Mapping varies based on destination IP. You may be behind a hard NAT._
189+
190+
**Problem:** This is a warning shown when multiple attempts to determine our
191+
public IP address/port via STUN resulted in different `ip:port` combinations.
192+
This is a sign that you are behind a "hard NAT", and may result in difficulty
193+
establishing direct connections. However, it does not mean that direct
194+
connections are impossible.
195+
196+
**Solution:** Engage with your network administrator.
197+
173198
## Websocket
174199

175200
Coder makes heavy use of [WebSockets](https://datatracker.ietf.org/doc/rfc6455/)

0 commit comments

Comments
 (0)