> ## Documentation Index
> Fetch the complete documentation index at: https://planetscale.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloudflare

> Create and pay for PlanetScale Postgres or MySQL databases from the Cloudflare dashboard without adding billing details to PlanetScale.

You can create PlanetScale Postgres or MySQL databases directly from the Cloudflare dashboard and pay for usage through your [Cloudflare account](https://developers.cloudflare.com/fundamentals/setup/account/create-account/).

Resources are provisioned in your PlanetScale account with normal dashboard access. Your billing page in the PlanetScale dashboard will indicate that some billing is handled through Cloudflare.

## When to use this

Use this flow when you want a PlanetScale database for [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Hyperdrive](https://developers.cloudflare.com/hyperdrive/) with billing unified in Cloudflare.

If you already have a PlanetScale database, or prefer to manage billing on PlanetScale directly, see [Connect an existing database](#connect-an-existing-database) below.

## Before you begin

Before you can create a Cloudflare-billed PlanetScale database, you'll need:

* A [Cloudflare account](https://developers.cloudflare.com/fundamentals/setup/account/create-account/)
* A PlanetScale account (you can create one during setup)

## Create a database from Cloudflare

<Steps>
  <Step>
    Log in to the Cloudflare dashboard and navigate to **Storage & databases** > **Postgres & MySQL (Hyperdrive)**.

    <Frame>
      <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/cf_create_planetscale_db-light.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=1a44f9fcffb3dfe41122ff3e0e63b001" alt="Create a PlanetScale database from the Cloudflare dashboard" className="block dark:hidden" width="1024" height="624" data-path="connect/assets/cf_create_planetscale_db-light.png" />

      <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/cf_create_planetscale_db-darkmode.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=8280f8c2eda53d68a85e69b9eb347cc1" alt="Create a PlanetScale database from the Cloudflare dashboard" className="hidden dark:block" width="1024" height="624" data-path="connect/assets/cf_create_planetscale_db-darkmode.png" />
    </Frame>
  </Step>

  <Step>
    Click **Create PlanetScale database**.
  </Step>

  <Step>
    Under **New PlanetScale database**, select your PlanetScale organization.

    <Frame>
      <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/cf_select_planetscale_db-light.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=d51eddc2f1e834399cc34e02cf6df5d5" alt="Select your PlanetScale organization in the Cloudflare dashboard" className="block dark:hidden" width="1024" height="837" data-path="connect/assets/cf_select_planetscale_db-light.png" />

      <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/cf_select_planetscale_db-darkmode.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=9d764b6d667f12ca34f39e288834d50c" alt="Select your PlanetScale organization in the Cloudflare dashboard" className="hidden dark:block" width="1024" height="837" data-path="connect/assets/cf_select_planetscale_db-darkmode.png" />
    </Frame>
  </Step>

  <Step>
    Click **Create database** to be redirected to the PlanetScale dashboard to finish configuration.
  </Step>
</Steps>

## Finish setup on PlanetScale

After Cloudflare redirects you to PlanetScale, configure your database:

* Database name
* Engine (Postgres or MySQL/Vitess)
* Region
* Cluster size

When you create the database, PlanetScale automatically associates it with your Cloudflare account. You have the same access to PlanetScale features as normal, including the MCP server, branching, query insights, roles, and backups.

## Billing

PlanetScale usage for databases created through Cloudflare is billed at [standard PlanetScale pricing](https://planetscale.com/pricing) through your Cloudflare account.

To confirm billing is routed through Cloudflare, go to your PlanetScale organization **Settings** > **Billing**. You'll see a banner indicating that some billing is handled through Cloudflare, with a link to your Cloudflare billing page.

<Frame>
  <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/ps_paid_via_cloudflare-light.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=f86a8415704451b4c27b9a0bca3976db" alt="PlanetScale billing page showing some billing through Cloudflare" className="block dark:hidden" width="781" height="233" data-path="connect/assets/ps_paid_via_cloudflare-light.png" />

  <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/ps_paid_via_cloudflare-darkmode.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=964cd588b5f2af8ae7b932db90912e5f" alt="PlanetScale billing page showing some billing through Cloudflare" className="hidden dark:block" width="781" height="233" data-path="connect/assets/ps_paid_via_cloudflare-darkmode.png" />
</Frame>

## Connect Hyperdrive

Once your database is ready, a banner at the top of the PlanetScale dashboard directs you back to the Cloudflare dashboard to set up Hyperdrive.

<Frame>
  <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/ps_hyperdrive_banner-light.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=ed5cdcc4e668e6e2a03461068a8a7bc1" alt="PlanetScale dashboard banner directing to Cloudflare Hyperdrive setup" className="block dark:hidden" width="1024" height="557" data-path="connect/assets/ps_hyperdrive_banner-light.png" />

  <img src="https://mintcdn.com/planetscale-2/G873q0u1kC24Q7We/connect/assets/ps_hyperdrive_banner-darkmode.png?fit=max&auto=format&n=G873q0u1kC24Q7We&q=85&s=cc79042738e229c6bf70dc40b8e1e2bd" alt="PlanetScale dashboard banner directing to Cloudflare Hyperdrive setup" className="hidden dark:block" width="1024" height="557" data-path="connect/assets/ps_hyperdrive_banner-darkmode.png" />
</Frame>

Hyperdrive connects your Worker to PlanetScale with connection pooling and query caching. For step-by-step Hyperdrive setup instructions, see:

* [PlanetScale Postgres with Cloudflare Workers](/postgres/tutorials/planetscale-postgres-cloudflare-workers)
* [Cloudflare Workers database integration (Vitess/MySQL)](/vitess/integrations/cloudflare-workers)

For Cloudflare's own documentation, see [PlanetScale on Cloudflare Workers](https://developers.cloudflare.com/workers/databases/third-party-integrations/planetscale/).

## Connect an existing database

You can still connect an existing PlanetScale database to Hyperdrive without using Cloudflare billing. This is the right path if you have already created a database on PlanetScale and want to link it to a Hyperdrive configuration.

In the Cloudflare Hyperdrive wizard, choose **Connect to PlanetScale database** and sign in to your existing PlanetScale account.

See the integration guides for full setup instructions:

* [PlanetScale Postgres with Cloudflare Workers](/postgres/tutorials/planetscale-postgres-cloudflare-workers)
* [Cloudflare Workers database integration (Vitess/MySQL)](/vitess/integrations/cloudflare-workers)

## Further reading

* [PlanetScale for Cloudflare users](https://planetscale.com/cloudflare) — overview of the PlanetScale + Cloudflare stack
* [Cloudflare Hyperdrive documentation](https://developers.cloudflare.com/hyperdrive/)
* [Faster PlanetScale Postgres connections with Cloudflare Hyperdrive](https://planetscale.com/blog/cloudflare-hyperdrive-real-time) — build a real-time application with PlanetScale and the Cloudflare global network

## Need help?

Get help from [the PlanetScale Support team](https://planetscale.com/contact?initial=support), or join our [Discord community](https://pscale.link/community) to see how others are using PlanetScale.