--- description: Configuration, connection, and query limits that apply to Hyperdrive. title: Limits image: https://developers.cloudflare.com/og-docs.png --- [Skip to content](#main-content) > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/hyperdrive/llms.txt > Use this file to discover all available pages before exploring further. # Limits Last updated Aug 25, 2026|Copy as Markdown|[View as Markdown](https://4f1c5cd2.previews.developers.cloudflare.com/hyperdrive/platform/limits/index.md)|[Agent setup](https://4f1c5cd2.previews.developers.cloudflare.com/agent-setup/) The following limits apply to Hyperdrive configurations, connections, and queries made to your configured origin databases. ## Configuration limits These limits apply when creating or updating Hyperdrive configurations. | Limit | Free | Paid | | ---------------------------------------------------- | --------------------- | --------------------- | | Maximum configured databases | 10 per account | 25 per account | | Maximum username length [1](#user-content-fn-1) | 63 characters (bytes) | 63 characters (bytes) | | Maximum database name length [1](#user-content-fn-1) | 63 characters (bytes) | 63 characters (bytes) | ## Connection limits These limits apply to connections between Hyperdrive and your origin database. | Limit | Free | Paid | | ------------------------------------------------------------------------------- | ---------------- | ----------------- | | Initial connection timeout | 15 seconds | 15 seconds | | Idle connection timeout | 10 minutes | 10 minutes | | Maximum origin database connections (per configuration) [2](#user-content-fn-2) | \~20 connections | \~100 connections | Hyperdrive does not limit the number of concurrent client connections from your Workers. However, Hyperdrive limits connections to your origin database because most hosted databases have connection limits. ### Connection errors When Hyperdrive cannot acquire a connection to your origin database, you may see one of the following errors: | Error message | Cause | | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Failed to acquire a connection from the pool. | The connection pool is exhausted because connections are held open too long. Long-running queries or transactions are a common cause. | | Server connection attempt failed: connection\_refused | Your origin database is rejecting connections. This can occur when a firewall blocks Hyperdrive, or when your database provider's connection limit is exceeded. | For a complete list of error codes, refer to [Troubleshoot and debug](https://4f1c5cd2.previews.developers.cloudflare.com/hyperdrive/observability/troubleshooting/). ## Query limits These limits apply to queries sent through Hyperdrive. | Limit | Free | Paid | | ---------------------------------- | ---------- | ---------- | | Maximum query (statement) duration | 60 seconds | 60 seconds | | Maximum cached query response size | 50 MB | 50 MB | Queries exceeding the maximum duration are terminated. Query responses larger than 50 MB are not cached but are still returned to your Worker. ## Request a limit increase You can request adjustments to limits that conflict with your project goals by contacting Cloudflare. Not all limits can be increased. To request an increase, submit a [Limit Increase Request form ↗](https://forms.gle/eX6pXvit1wBv77Yw5). You can also ask questions in the Hyperdrive channel on [Cloudflare's Discord community ↗](https://discord.cloudflare.com/). ## Footnotes 1. This is a limit enforced by PostgreSQL. Some database providers may enforce smaller limits. [↩](#user-content-fnref-1) [↩2](#user-content-fnref-1-2) 2. Hyperdrive is a distributed system, so a client may be unable to reach an existing pool. In this scenario, a new pool is established with its own connection allocation. This prioritizes availability over strict limit enforcement, which means connection counts may occasionally exceed the listed limits. [↩](#user-content-fnref-2) Was this helpful? YesNo ## On this page [![](https://4f1c5cd2.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://4f1c5cd2.previews.developers.cloudflare.com/) ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/hyperdrive/platform/limits/#page","headline":"Limits · Cloudflare Hyperdrive docs","description":"Configuration, connection, and query limits that apply to Hyperdrive.","url":"https://developers.cloudflare.com/hyperdrive/platform/limits/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-25","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}} ```