diff --git a/src/content/changelog/hyperdrive/2026-08-07-hyperdrive-restart-configuration-dashboard.mdx b/src/content/changelog/hyperdrive/2026-08-07-hyperdrive-restart-configuration-dashboard.mdx new file mode 100644 index 00000000000..7841a8e8145 --- /dev/null +++ b/src/content/changelog/hyperdrive/2026-08-07-hyperdrive-restart-configuration-dashboard.mdx @@ -0,0 +1,19 @@ +--- +title: Restart a Hyperdrive configuration from the dashboard +description: Restart a Hyperdrive configuration to drain its connection pool and establish new connections to your database. +products: + - hyperdrive +date: 2026-08-07 +--- + +You can now restart a Hyperdrive configuration from the Cloudflare dashboard. Restarting a configuration drains its connection pool and establishes new connections to your origin database. + +To restart a configuration, select your Hyperdrive configuration in the [Cloudflare dashboard](https://dash.cloudflare.com), go to the **Settings** tab, and select **Restart** under **Danger zone**. + +Use a restart to rebuild the connection pool during a database failover or a similar event, without recreating the configuration. After a configuration has been restarted, the **Settings** tab shows when it was last restarted. + +:::caution +Restarting a Hyperdrive configuration drops all active connections in your connection pool and forces them to be re-established. In-flight queries may see brief errors while the pool rebuilds. +::: + +For more information, refer to [Connection pooling](/hyperdrive/concepts/connection-pooling/). diff --git a/src/content/docs/hyperdrive/concepts/connection-pooling.mdx b/src/content/docs/hyperdrive/concepts/connection-pooling.mdx index b206c5f3d34..0bd128e6213 100644 --- a/src/content/docs/hyperdrive/concepts/connection-pooling.mdx +++ b/src/content/docs/hyperdrive/concepts/connection-pooling.mdx @@ -24,6 +24,16 @@ Hyperdrive will automatically scale the amount of database connections held open The `max_size` parameter acts as a soft limit - Hyperdrive may temporarily create additional connections during network issues or high traffic periods to ensure high availability and resiliency. +## Restart the connection pool + +Hyperdrive manages the connection pool for you. You can also restart the pool manually from the Cloudflare dashboard. Select your Hyperdrive configuration, go to the **Settings** tab, and select **Restart** under **Danger zone**. + +Restarting a configuration drains the existing connection pool and establishes new connections to your origin database. Use a restart to rebuild the pool during a database failover or a similar event, without recreating the configuration. + +:::caution +Restarting a configuration drops all active connections in your connection pool and forces them to be re-established. In-flight queries may see brief errors while the pool rebuilds. +::: + ## Pooling mode diff --git a/src/content/docs/hyperdrive/configuration/rotate-credentials.mdx b/src/content/docs/hyperdrive/configuration/rotate-credentials.mdx index c9827645f3d..368bcdd99b6 100644 --- a/src/content/docs/hyperdrive/configuration/rotate-credentials.mdx +++ b/src/content/docs/hyperdrive/configuration/rotate-credentials.mdx @@ -60,5 +60,5 @@ npx wrangler hyperdrive update --origin-host