Skip to content
Open
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
Original file line number Diff line number Diff line change
@@ -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/).
10 changes: 10 additions & 0 deletions src/content/docs/hyperdrive/concepts/connection-pooling.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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

<Render file="pooling-mode" product="hyperdrive" />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,5 +60,5 @@ npx wrangler hyperdrive update <HYPERDRIVE_CONFIG_ID> --origin-host <YOUR_ORIGIN
```

:::note
Updating the settings of an existing Hyperdrive configuration does not purge Hyperdrive's cache and does not tear down the existing database connection pool. New connections will be established using the new connection information.
Updating the settings of an existing Hyperdrive configuration does not purge Hyperdrive's cache and does not tear down the existing database connection pool. New connections will be established using the new connection information. To drain the existing pool and force new connections immediately, [restart the connection pool](/hyperdrive/concepts/connection-pooling/#restart-the-connection-pool).
:::