Configuration

HTTP Server

Different ways to run your RivetKit HTTP server.

Methods of Running Your Server

With Fetch Handlers

A fetch handler is a function that takes a Request and returns a Response. This is the standard pattern used by Cloudflare Workers, Deno Deploy, Bun, and other modern runtimes.

The simplest setup uses registry.serve():

import { registry } from "./registry";

export default registry.serve();

server.ts

To integrate with a router like Hono or Elysia, use registry.handler():

import { Hono } from "hono";
import { registry } from "./registry";

const app = new Hono();
app.get("/health", (c) => c.text("OK"));
app.all("/api/rivet/*", (c) => registry.handler(c.req.raw));

export default app;

server.ts

import { Elysia } from "elysia";
import { registry } from "./registry";

const app = new Elysia()
  .get("/health", () => "OK")
  .all("/api/rivet/*", ({ request }) => registry.handler(request));

export default app;

server.ts

Then run your server:

npx srvx server.ts

Node.js

bun server.ts

Bun

deno run --allow-net --allow-read --allow-env server.ts

Deno

srvx is a universal server runner for fetch handlers. It compiles TypeScript on-the-fly for Node.js and can be used in production. Bun and Deno support fetch handlers and TypeScript natively.

Explicit HTTP Server

If you need to explicitly start the HTTP server instead of using the fetch handler pattern:

Using Hono with @hono/node-server:

import { Hono } from "hono";
import { serve } from "@hono/node-server";
import { registry } from "./registry";

const app = new Hono();
app.all("/api/rivet/*", (c) => registry.handler(c.req.raw));

serve({ fetch: app.fetch, port: 3000 });

server.ts

Using @whatwg-node/server to adapt the fetch handler to Node’s HTTP server:

import { registry } from "./registry";
import { createServer } from "node:http";
import { createServerAdapter } from "@whatwg-node/server";

const handler = createServerAdapter(registry.serve().fetch);
const server = createServer(handler);
server.listen(3000);

server.ts

Using Bun’s native server:

import { registry } from "./registry";

Bun.serve({
  port: 3000,
  fetch: (request) => registry.handler(request),
});

server.ts

Using Deno’s native server:

import { registry } from "./registry";

Deno.serve({ port: 3000 }, (request) => registry.handler(request));

server.ts