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

# Deploy a Bun application on Vercel

[Vercel](https://vercel.com/) is a cloud platform for building, deploying, and scaling apps. Vercel Functions can run on the Bun runtime, either behind a framework that Vercel supports or as a [`Bun.serve()`](https://bun.com/docs/runtime/http/server) server.

> [!WARNING]
>
> The Bun runtime on Vercel is in Beta. Automatic source maps, bytecode caching, and request metrics for `node:http` and
> `node:https` are not supported yet (request metrics for `fetch` are). See [feature
> support](https://vercel.com/docs/functions/runtimes/bun#feature-support) in the Vercel documentation.

***

**1. Configure Bun in vercel.json**

To run your Functions on Bun, add a [`bunVersion`](https://vercel.com/docs/project-configuration/vercel-json#bunversion) field to your `vercel.json` file:

```json vercel.json icon="file-json" theme={"theme":{"light":"github-light","dark":"dracula"}}
{
	"bunVersion": "1.x" // [!code ++]
}
```

The value must be `"1.x"`; Vercel manages the minor and patch versions.

For best results, match your local Bun version with the version Vercel uses.

**2. Add a server**

Choose how requests reach your code.

> [tab] Bun.serve() for the whole app
>
> Vercel's Bun framework preset sends every request for the deployment to a single `Bun.serve()` server. Vercel uses the preset when the project sets `bunVersion`, has a `bun.lock` file, and has a server entrypoint at one of these paths:
>
> * `server.{js,cjs,mjs,ts,cts,mts}`
> * `src/server.{js,cjs,mjs,ts,cts,mts}`
>
> `bun install` creates `bun.lock` on Bun 1.2 or later. On older versions, run `bun install --save-text-lockfile`. The preset does not detect the binary `bun.lockb` format.
>
> Call `Bun.serve()` once while the module loads. Vercel detects that call and routes incoming requests to it. Vercel supports the `fetch`, [`routes`](https://bun.com/docs/runtime/http/routing), `error`, and `websocket` options:
>
> ```ts server.ts icon="https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/typescript.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=7ac549adaea8d5487d8fbd58cc3ea35b" theme={"theme":{"light":"github-light","dark":"dracula"}}
> Bun.serve({
> 	routes: {
> 		"/health": () => Response.json({ status: "ok" }),
> 	},
> 	fetch() {
> 		return new Response("Hello from Bun on Vercel");
> 	},
> });
> ```
>
> A minimal project is `package.json`, `bun.lock`, `server.ts`, and the `vercel.json` from the previous step. It doesn't need an `api/` directory or any routing configuration.
>
> > [!NOTE]
> >
> > `port` and `hostname` only apply when you run the server locally; they don't configure the deployed endpoint. Unix sockets and [HTML imports](https://bun.com/docs/runtime/http/server.md#html-imports) in `routes` are not supported on Vercel.
> >
> > To serve WebSocket connections, see the [Bun example in Vercel's WebSockets documentation](https://vercel.com/docs/functions/websockets#bun).

> [tab] Bun.serve() under /api
>
> To add a Bun server to a project that also has a frontend, create `api/server.ts` and call `Bun.serve()` once while the module loads. Vercel deploys it as a single Function at `/api/server`. Unlike the framework preset, only requests for `/api/server` reach this server.
>
> ```ts api/server.ts icon="https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/typescript.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=7ac549adaea8d5487d8fbd58cc3ea35b" theme={"theme":{"light":"github-light","dark":"dracula"}}
> Bun.serve({
> 	fetch(request) {
> 		const url = new URL(request.url);
>
> 		return Response.json({
> 			message: "Hello from Bun on Vercel",
> 			pathname: url.pathname,
> 		});
> 	},
> });
> ```
>
> This setup only needs the `bunVersion` setting from the previous step; it doesn't use the framework preset or require a `bun.lock` file. To send other paths to this server, add route overrides to `vercel.json`. Each override must use the full request path, including the `/api/server` prefix. See [the Vercel Bun runtime documentation](https://vercel.com/docs/functions/runtimes/bun) for details.

> [tab] Next.js or another framework
>
> Frameworks that Vercel supports, such as Next.js, Express, Hono, and Nitro, run on Bun once you set `bunVersion`.
>
> If you're deploying a **Next.js** project (including ISR), also update the `package.json` scripts so the Next.js CLI runs under Bun:
>
> ```json package.json icon="file-json" theme={"theme":{"light":"github-light","dark":"dracula"}}
> {
> 	"scripts": {
> 		"dev": "bun --bun next dev", // [!code ++]
> 		"build": "bun --bun next build" // [!code ++]
> 	}
> }
> ```
>
> > [!NOTE]
> >
> > The `--bun` flag runs the Next.js CLI under Bun. Bundling (with Turbopack or Webpack) is unchanged.

**3. Deploy your app**

Connect your repository to Vercel, or deploy from the CLI:

```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
# Using bunx (no global install)
bunx vercel login
bunx vercel deploy
```

Or install the Vercel CLI globally:

```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
bun i -g vercel
vercel login
vercel deploy
```

[Learn more in the Vercel Deploy CLI documentation →](https://vercel.com/docs/cli/deploy)

**4. Verify the runtime**

To confirm your deployment uses Bun, log the Bun version:

```ts server.ts icon="https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/typescript.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=7ac549adaea8d5487d8fbd58cc3ea35b" theme={"theme":{"light":"github-light","dark":"dracula"}}
console.log("runtime", process.versions.bun);
```

```txt theme={"theme":{"light":"github-light","dark":"dracula"}}
runtime 1.3.14
```

[See the Vercel Bun Runtime documentation for feature support →](https://vercel.com/docs/functions/runtimes/bun#feature-support)

***

* [Fluid compute](https://vercel.com/docs/fluid-compute): Both Bun and Node.js runtimes run on Fluid compute and support the same core Vercel Functions features.
* [Middleware](https://vercel.com/docs/routing-middleware): To run Routing Middleware with Bun, set the runtime to `nodejs`:

```ts middleware.ts icon="https://mintcdn.com/bun-1dd33a4e/JUhaF6Mf68z_zHyy/icons/typescript.svg?fit=max&auto=format&n=JUhaF6Mf68z_zHyy&q=85&s=7ac549adaea8d5487d8fbd58cc3ea35b" theme={"theme":{"light":"github-light","dark":"dracula"}}
export const config = { runtime: "nodejs" }; // [!code ++]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.