Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions content/docs/connect/connection-errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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<endpoint-id>'. 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.
Expand Down Expand Up @@ -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.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).

## You have exceeded the limit of concurrently active endpoints
Expand Down
2 changes: 1 addition & 1 deletion next.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading