Skip to content

Commit 2596564

Browse files
committed
Add reverse-proxy troubleshooting section to Kubernetes docs
1 parent b2a2e05 commit 2596564

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

docs/self-hosted/kubernetes-troubleshooting.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,3 +36,27 @@ System.
3636
> a year. As Private Packagist only allows a time-drift of up to one (1) minute, we
3737
> recommend using TOTP devices that have the ability to stay synchronized with
3838
> the correct time (such as a phone, or re-programmable TOTP hardware devices).
39+
40+
#### Issues with Reverse-Proxy running in front of the Kubernetes Cluster
41+
42+
Please follow the instructions below, if you are experiencing problems with the reverse-proxy not being able to connect to
43+
the cluster and encountering errors like this:
44+
```
45+
Peer closed connection in SSL handshake (104: Connection reset by peer) while SSL handshaking to upstream
46+
```
47+
48+
Ensure that the SNI (Server Name Indication) TLS Extension is properly passed in requests to the cluster
49+
for SNI to work correctly on the ingress. When using IPs as upstream hostnames on the reverse-proxy, this is not the case
50+
by default and will result in a certificate error.
51+
52+
To pass the SNI hostname from the incoming request to the upstream server, apply the following settings when using
53+
NGINX as a reverse-proxy:
54+
```
55+
proxy_ssl_name $host;
56+
proxy_ssl_server_name on;
57+
```
58+
59+
If you are using different hostnames on the upstream and on the reverse-proxy, set the value in the
60+
`proxy_ssl_name` directive to the corresponding hostname of the upstream server.
61+
62+
Please consult the documentation of other reverse-proxy servers to achieve the same result.

0 commit comments

Comments
 (0)