From aef0d4a4aecaa29043a2d44419deced5113f1a1f Mon Sep 17 00:00:00 2001 From: omnigent Date: Mon, 9 Nov 2026 17:21:39 +0000 Subject: [PATCH 1/3] docs: match proxy error text on connection errors LKB-20979 Co-authored-by: Isaac --- content/docs/connect/connection-errors.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/docs/connect/connection-errors.md b/content/docs/connect/connection-errors.md index fff8dc69218..68c52aef70d 100644 --- a/content/docs/connect/connection-errors.md +++ b/content/docs/connect/connection-errors.md @@ -13,7 +13,7 @@ enableTableOfContents: true redirectFrom: - /docs/how-to-guides/connectivity-issues - /docs/connect/connectivity-issues -updatedOn: '2026-09-16T19:45:35.340Z' +updatedOn: '2026-11-09T17:21:40.335Z' --- This topic describes how to resolve connection errors you may encounter when using Neon. The errors covered include: @@ -45,7 +45,7 @@ Connection problems are sometimes related to a system issue. To check for system With older clients and some native Postgres clients, you may receive the following error when attempting to connect to Neon: ```txt shouldWrap -ERROR: The endpoint ID is not specified. Either upgrade the Postgres client library (libpq) for SNI support or pass the endpoint ID (the first part of the domain name) as a parameter: '&options=endpoint%3D'. See [https://neon.com/sni](/sni) for more information. +ERROR: Endpoint ID is not specified. Either please upgrade the postgres client library (libpq) for SNI support or pass the endpoint ID (first part of the domain name) as a parameter: '?options=endpoint%3D'. See more at https://neon.tech/sni ``` This error occurs if your client library or application does not support the **Server Name Indication (SNI)** mechanism in TLS. @@ -210,6 +210,8 @@ unsupported startup parameter: <...> unsupported startup parameter in options: <...> ``` +In both variations, the message ends with: `Please use unpooled connection or remove this parameter from the startup package. More details: https://neon.tech/docs/connect/connection-errors#unsupported-startup-parameter`. + The error occurs when using a pooled Neon connection string with startup options that are not supported by PgBouncer. PgBouncer allows only startup parameters it can keep track of in startup packets. These include: `client_encoding`, `datestyle`, `timezone`, `standard_conforming_strings`, and `application_name`. See **track_extra_parameters**, in the [PgBouncer documentation](https://www.pgbouncer.org/config.html#track_extra_parameters). To resolve this error, you can either remove the unsupported parameter from your connection string or use an unpooled Neon connection string. For information about pooled and unpooled connections in Neon, see [Connection pooling](/docs/connect/connection-pooling). ## You have exceeded the limit of concurrently active endpoints From 455075b04daa9f3cf320327235021df1d2d7173f Mon Sep 17 00:00:00 2001 From: Daniel Price Date: Tue, 17 Nov 2026 16:13:32 -0400 Subject: [PATCH 2/3] docs: use neon.com URLs in quoted proxy error text Co-authored-by: Isaac --- content/docs/connect/connection-errors.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/connect/connection-errors.md b/content/docs/connect/connection-errors.md index 68c52aef70d..cb9946add9c 100644 --- a/content/docs/connect/connection-errors.md +++ b/content/docs/connect/connection-errors.md @@ -45,7 +45,7 @@ Connection problems are sometimes related to a system issue. To check for system With older clients and some native Postgres clients, you may receive the following error when attempting to connect to Neon: ```txt shouldWrap -ERROR: Endpoint ID is not specified. Either please upgrade the postgres client library (libpq) for SNI support or pass the endpoint ID (first part of the domain name) as a parameter: '?options=endpoint%3D'. See more at https://neon.tech/sni +ERROR: Endpoint ID is not specified. Either please upgrade the postgres client library (libpq) for SNI support or pass the endpoint ID (first part of the domain name) as a parameter: '?options=endpoint%3D'. See more at https://neon.com/sni ``` This error occurs if your client library or application does not support the **Server Name Indication (SNI)** mechanism in TLS. @@ -210,7 +210,7 @@ unsupported startup parameter: <...> unsupported startup parameter in options: <...> ``` -In both variations, the message ends with: `Please use unpooled connection or remove this parameter from the startup package. More details: https://neon.tech/docs/connect/connection-errors#unsupported-startup-parameter`. +In both variations, the message ends with: `Please use unpooled connection or remove this parameter from the startup package. More details: https://neon.com/docs/connect/connection-errors#unsupported-startup-parameter`. The error occurs when using a pooled Neon connection string with startup options that are not supported by PgBouncer. PgBouncer allows only startup parameters it can keep track of in startup packets. These include: `client_encoding`, `datestyle`, `timezone`, `standard_conforming_strings`, and `application_name`. See **track_extra_parameters**, in the [PgBouncer documentation](https://www.pgbouncer.org/config.html#track_extra_parameters). To resolve this error, you can either remove the unsupported parameter from your connection string or use an unpooled Neon connection string. For information about pooled and unpooled connections in Neon, see [Connection pooling](/docs/connect/connection-pooling). From 9cf87b4067d42877d94fa98460c1a78f54d85795 Mon Sep 17 00:00:00 2001 From: Daniel Price Date: Tue, 17 Nov 2026 16:50:45 -0400 Subject: [PATCH 3/3] fix: point /sni redirect at the endpoint ID section Co-authored-by: Isaac --- next.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/next.config.js b/next.config.js index 2586973fee1..bfad81c5cad 100644 --- a/next.config.js +++ b/next.config.js @@ -2275,7 +2275,7 @@ const defaultConfig = { // Proxy has an error message, that suggests to read `https://neon.com/sni` for more details. { source: '/sni', - destination: '/docs/connect/connection-errors', + destination: '/docs/connect/connection-errors#the-endpoint-id-is-not-specified', permanent: true, }, // NOTE: bare `/docs` is the docs front page (src/app/(docs)/docs/page.jsx) and