Deploy guide · runtime = "node"

Ship Hono in ~2 minutes.

Hono is a lightweight, web-standard TypeScript router that runs anywhere — Bun, Node, Workers. On Percher it ships on the Node runtime by default, with the same fast cold builds as any other Node app.

Why Percher fits

Hono's web-standard `Request`/`Response` plays nicely with Percher's Node container — no platform-specific adapters needed.
Tiny image footprint (Hono itself is ~12 kB) means fast cold starts on the Free tier.

Quick start

bunx percher create my-app --template hono
cd my-app
bunx percher publish

The first command scaffolds a working Hono project plus a percher.toml. Publish builds and deploys it, then prints the live URL.

percher.toml

The canonical config for a Hono app on Percher. bunx percher init generates this automatically when it detects Hono in your project.

[app]
name = "my-api"
runtime = "node"
framework = "hono"

[web]
port = 3000
health = "/health"

Common gotchas

Don't import the Cloudflare Workers entry — use `import { Hono } from "hono"` and serve with `@hono/node-server` for the Node runtime.
Set the listen port from `process.env.PORT` (or `3000`); Hono doesn't infer it.

Related docs

Ready to deploy Hono?

Start on the Free plan. No credit card, live in ~2 minutes.