Deploy guide · runtime = "node"

Deploy Hono on Percher

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; the live URL prints on completion.

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

• Quick start →
• Recommended setup →

Ready to deploy Hono?

Free plan, no credit card. Live in under a minute.