Skip to main content
Vercel is a cloud platform that lets you build, deploy, and scale your apps.
The Bun runtime is in Beta; certain features (e.g., automatic source maps, byte-code caching, metrics on node:http/https) are not yet supported.
Bun.serve is currently not supported on Vercel Functions.Use Bun with frameworks supported by Vercel, like Next.js, Express, Hono, or Nitro.
1

Configure Bun in vercel.json

To enable the Bun runtime for your Functions, add a bunVersion field in your vercel.json file:
vercel.json
{
	"bunVersion": "1.x"
}
Vercel automatically detects this configuration and runs your application on Bun. The value has to be "1.x", Vercel handles the minor version internally.For best results, match your local Bun version with the version used by Vercel. Currently, Bun version 1.2.23 is supported.
2

Next.js configuration

If you’re deploying a Next.js project (including ISR), update your package.json scripts to use the Bun runtime:
package.json
{
	"scripts": {
		"dev": "bun --bun next dev", 
		"build": "bun --bun next build"
	}
}
The --bun flag runs the Next.js CLI under Bun. Bundling (via Turbopack or Webpack) remains unchanged, but all commands execute within the Bun runtime.
This ensures both local development and builds use Bun.
3

Deploy your app

Connect your repository to Vercel, or deploy from the CLI:
terminal
# Using bunx (no global install)
bunx vercel login
bunx vercel deploy
Or install the Vercel CLI globally:
terminal
bun i -g vercel
vercel login
vercel deploy
Learn more in the Vercel Deploy CLI documentation →
4

Verify the runtime

To confirm your deployment uses Bun, log the Bun version:
https://mintcdn.com/bun-1dd33a4e/Hq64iapoQXHbYMEN/icons/typescript.svg?fit=max&auto=format&n=Hq64iapoQXHbYMEN&q=85&s=c6cceedec8f82d2cc803d7c6ec82b240index.ts
console.log("runtime", process.versions.bun);

runtime 1.2.23
See the Vercel Bun Runtime documentation for feature support →
  • Fluid compute: Both Bun and Node.js runtimes run on Fluid compute and support the same core Vercel Functions features.
  • Middleware: To run Routing Middleware with Bun, set the runtime to nodejs:
https://mintcdn.com/bun-1dd33a4e/Hq64iapoQXHbYMEN/icons/typescript.svg?fit=max&auto=format&n=Hq64iapoQXHbYMEN&q=85&s=c6cceedec8f82d2cc803d7c6ec82b240middleware.ts
export const config = { runtime: "nodejs" };