--- title: Hyperdrive description: Wrangler commands for managing Hyperdrive database configurations. image: https://developers.cloudflare.com/dev-products-preview.png --- > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt > Use this file to discover all available pages before exploring further. [Skip to content](#%5Ftop) # Hyperdrive Manage [Hyperdrive](https://developers.cloudflare.com/hyperdrive/) database configurations using Wrangler. To manage mTLS client certificates and CA chain certificates used by Hyperdrive, refer to [Certificate commands](https://developers.cloudflare.com/workers/wrangler/commands/certificates/). ## `hyperdrive create` Create a Hyperdrive config * [ npm ](#tab-panel-9918) * [ pnpm ](#tab-panel-9919) * [ yarn ](#tab-panel-9920) Terminal window ``` npx wrangler hyperdrive create [NAME] ``` Terminal window ``` pnpm wrangler hyperdrive create [NAME] ``` Terminal window ``` yarn wrangler hyperdrive create [NAME] ``` * `[NAME]` ` string ` required The name of the Hyperdrive config * `--connection-string` ` string ` The connection string for the database you want Hyperdrive to connect to - ex: protocol://user:password@host:port/database * `--service-id` ` string ` The Workers VPC Service ID of the origin database * `--origin-host` ` string ` alias: --host The host of the origin database * `--origin-port` ` number ` alias: --port The port number of the origin database * `--origin-scheme` ` string ` alias: --scheme default: postgresql The scheme used to connect to the origin database * `--database` ` string ` The name of the database within the origin database * `--origin-user` ` string ` alias: --user The username used to connect to the origin database * `--origin-password` ` string ` alias: --password The password used to connect to the origin database * `--access-client-id` ` string ` The Client ID of the Access token to use when connecting to the origin database * `--access-client-secret` ` string ` The Client Secret of the Access token to use when connecting to the origin database * `--caching-disabled` ` boolean ` Disables the caching of SQL responses * `--max-age` ` number ` Specifies max duration for which items should persist in the cache, cannot be set when caching is disabled * `--swr` ` number ` Indicates the number of seconds cache may serve the response after it becomes stale, cannot be set when caching is disabled * `--ca-certificate-id` ` string ` alias: --ca-certificate-uuid Sets custom CA certificate when connecting to origin database. Must be valid UUID of already uploaded CA certificate. * `--mtls-certificate-id` ` string ` alias: --mtls-certificate-uuid Sets custom mTLS client certificates when connecting to origin database. Must be valid UUID of already uploaded public/private key certificates. * `--sslmode` ` string ` Sets sslmode for connecting to database. For PostgreSQL: 'require, verify-ca, verify-full'. For MySQL: 'REQUIRED, VERIFY\_CA, VERIFY\_IDENTITY'. * `--origin-connection-limit` ` number ` The (soft) maximum number of connections that Hyperdrive may establish to the origin database * `--binding` ` string ` The binding name of this resource in your Worker * `--update-config` ` boolean ` Automatically update your config file with the newly added resource Global flags * `--v` ` boolean ` alias: --version Show version number * `--cwd` ` string ` Run as if Wrangler was started in the specified directory instead of the current working directory * `--config` ` string ` alias: --c Path to Wrangler configuration file * `--env` ` string ` alias: --e Environment to use for operations, and for selecting .env and .dev.vars files * `--env-file` ` string ` Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files * `--experimental-provision` ` boolean ` aliases: --x-provision default: true Experimental: Enable automatic resource provisioning * `--experimental-auto-create` ` boolean ` alias: --x-auto-create default: true Automatically provision draft bindings with new resources ## `hyperdrive delete` Delete a Hyperdrive config * [ npm ](#tab-panel-9921) * [ pnpm ](#tab-panel-9922) * [ yarn ](#tab-panel-9923) Terminal window ``` npx wrangler hyperdrive delete [ID] ``` Terminal window ``` pnpm wrangler hyperdrive delete [ID] ``` Terminal window ``` yarn wrangler hyperdrive delete [ID] ``` * `[ID]` ` string ` required The ID of the Hyperdrive config Global flags * `--v` ` boolean ` alias: --version Show version number * `--cwd` ` string ` Run as if Wrangler was started in the specified directory instead of the current working directory * `--config` ` string ` alias: --c Path to Wrangler configuration file * `--env` ` string ` alias: --e Environment to use for operations, and for selecting .env and .dev.vars files * `--env-file` ` string ` Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files * `--experimental-provision` ` boolean ` aliases: --x-provision default: true Experimental: Enable automatic resource provisioning * `--experimental-auto-create` ` boolean ` alias: --x-auto-create default: true Automatically provision draft bindings with new resources ## `hyperdrive get` Get a Hyperdrive config * [ npm ](#tab-panel-9924) * [ pnpm ](#tab-panel-9925) * [ yarn ](#tab-panel-9926) Terminal window ``` npx wrangler hyperdrive get [ID] ``` Terminal window ``` pnpm wrangler hyperdrive get [ID] ``` Terminal window ``` yarn wrangler hyperdrive get [ID] ``` * `[ID]` ` string ` required The ID of the Hyperdrive config Global flags * `--v` ` boolean ` alias: --version Show version number * `--cwd` ` string ` Run as if Wrangler was started in the specified directory instead of the current working directory * `--config` ` string ` alias: --c Path to Wrangler configuration file * `--env` ` string ` alias: --e Environment to use for operations, and for selecting .env and .dev.vars files * `--env-file` ` string ` Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files * `--experimental-provision` ` boolean ` aliases: --x-provision default: true Experimental: Enable automatic resource provisioning * `--experimental-auto-create` ` boolean ` alias: --x-auto-create default: true Automatically provision draft bindings with new resources ## `hyperdrive list` List Hyperdrive configs * [ npm ](#tab-panel-9927) * [ pnpm ](#tab-panel-9928) * [ yarn ](#tab-panel-9929) Terminal window ``` npx wrangler hyperdrive list ``` Terminal window ``` pnpm wrangler hyperdrive list ``` Terminal window ``` yarn wrangler hyperdrive list ``` Global flags * `--v` ` boolean ` alias: --version Show version number * `--cwd` ` string ` Run as if Wrangler was started in the specified directory instead of the current working directory * `--config` ` string ` alias: --c Path to Wrangler configuration file * `--env` ` string ` alias: --e Environment to use for operations, and for selecting .env and .dev.vars files * `--env-file` ` string ` Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files * `--experimental-provision` ` boolean ` aliases: --x-provision default: true Experimental: Enable automatic resource provisioning * `--experimental-auto-create` ` boolean ` alias: --x-auto-create default: true Automatically provision draft bindings with new resources ## `hyperdrive update` Update a Hyperdrive config * [ npm ](#tab-panel-9930) * [ pnpm ](#tab-panel-9931) * [ yarn ](#tab-panel-9932) Terminal window ``` npx wrangler hyperdrive update [ID] ``` Terminal window ``` pnpm wrangler hyperdrive update [ID] ``` Terminal window ``` yarn wrangler hyperdrive update [ID] ``` * `[ID]` ` string ` required The ID of the Hyperdrive config * `--name` ` string ` Give your config a new name * `--connection-string` ` string ` The connection string for the database you want Hyperdrive to connect to - ex: protocol://user:password@host:port/database * `--service-id` ` string ` The Workers VPC Service ID of the origin database * `--origin-host` ` string ` alias: --host The host of the origin database * `--origin-port` ` number ` alias: --port The port number of the origin database * `--origin-scheme` ` string ` alias: --scheme The scheme used to connect to the origin database * `--database` ` string ` The name of the database within the origin database * `--origin-user` ` string ` alias: --user The username used to connect to the origin database * `--origin-password` ` string ` alias: --password The password used to connect to the origin database * `--access-client-id` ` string ` The Client ID of the Access token to use when connecting to the origin database * `--access-client-secret` ` string ` The Client Secret of the Access token to use when connecting to the origin database * `--caching-disabled` ` boolean ` Disables the caching of SQL responses * `--max-age` ` number ` Specifies max duration for which items should persist in the cache, cannot be set when caching is disabled * `--swr` ` number ` Indicates the number of seconds cache may serve the response after it becomes stale, cannot be set when caching is disabled * `--ca-certificate-id` ` string ` alias: --ca-certificate-uuid Sets custom CA certificate when connecting to origin database. Must be valid UUID of already uploaded CA certificate. * `--mtls-certificate-id` ` string ` alias: --mtls-certificate-uuid Sets custom mTLS client certificates when connecting to origin database. Must be valid UUID of already uploaded public/private key certificates. * `--sslmode` ` string ` Sets sslmode for connecting to database. For PostgreSQL: 'require, verify-ca, verify-full'. For MySQL: 'REQUIRED, VERIFY\_CA, VERIFY\_IDENTITY'. * `--origin-connection-limit` ` number ` The (soft) maximum number of connections that Hyperdrive may establish to the origin database Global flags * `--v` ` boolean ` alias: --version Show version number * `--cwd` ` string ` Run as if Wrangler was started in the specified directory instead of the current working directory * `--config` ` string ` alias: --c Path to Wrangler configuration file * `--env` ` string ` alias: --e Environment to use for operations, and for selecting .env and .dev.vars files * `--env-file` ` string ` Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files * `--experimental-provision` ` boolean ` aliases: --x-provision default: true Experimental: Enable automatic resource provisioning * `--experimental-auto-create` ` boolean ` alias: --x-auto-create default: true Automatically provision draft bindings with new resources ```json {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/workers/","name":"Workers"}},{"@type":"ListItem","position":3,"item":{"@id":"/workers/wrangler/","name":"Wrangler"}},{"@type":"ListItem","position":4,"item":{"@id":"/workers/wrangler/commands/","name":"Commands"}},{"@type":"ListItem","position":5,"item":{"@id":"/workers/wrangler/commands/hyperdrive/","name":"Hyperdrive"}}]} ```