OpenNext for Cloudflare

Deploy Next.js apps to Cloudflare!

OpenNext for Cloudflare is a Cloudflare specific adapter that enables deployment of Next.js applications to Cloudflare.

Get started

To get started with the adapter visit the official get started documentation.

Local development

you can use the regular next CLI to start the Next.js dev server:

Local preview

Run the following commands to preview the production build of your application locally:

build the app and adapt it for Cloudflare

npx opennextjs-cloudflare build
# or
pnpm opennextjs-cloudflare build
# or
yarn opennextjs-cloudflare build
# or
bun opennextjs-cloudflare build

Preview the app in Wrangler

npx wrangler dev
# or
pnpm wrangler dev
# or
yarn wrangler dev
# or
bun wrangler dev

Deploy your app

Deploy your application to production with the following:

build the app and adapt it for Cloudflare

npx opennextjs-cloudflare build && npx opennextjs-cloudflare deploy
# or
pnpm opennextjs-cloudflare build && pnpm opennextjs-cloudflare deploy
# or
yarn opennextjs-cloudflare build && yarn opennextjs-cloudflare deploy
# or
bun opennextjs-cloudflare build && bun opennextjs-cloudflare deploy

Batch Cache Population (Optional, Recommended)

For improved performance with large caches, you can enable batch upload by providing R2 credentials via .env or environment variables.

Create a .env file in your project root (automatically loaded by the CLI):

R2_ACCESS_KEY_ID=your_access_key_id
R2_SECRET_ACCESS_KEY=your_secret_access_key
CF_ACCOUNT_ID=your_account_id

You can also set the environment variables for CI builds.

Note:

You can follow documentation https://developers.cloudflare.com/r2/api/tokens/ for creating API tokens with appropriate permissions for R2 access.

Benefits:

Significantly faster uploads for large caches using parallel transfers
Reduced API calls to Cloudflare
Automatically enabled when credentials are provided

Fallback: If these environment variables are not set, the CLI will use standard Wrangler uploads. Both methods work correctly - batch upload is simply faster for large caches.