Migrating from Vercel
Move a static Vercel site to bunny.net and translate vercel.json into orbitpush.json.
orbitpush deploys static output only. A Vercel project that uses serverless functions, middleware or server-side rendering needs a static export first.
1. Set up the site
export BUNNY_API_KEY=...
npx orbitpush init
Use the directory from outputDirectory in vercel.json, or your framework’s static output directory, as the build output directory.
2. Translate vercel.json
There is no automatic migration from Vercel. vercel.json uses the same top-level names as orbitpush.json with different fields, so each entry needs rewriting:
vercel.json |
orbitpush.json |
|---|---|
redirects[].source, destination |
from, to |
/blog/:path* to /news/:path* |
/blog/* to /news/:splat |
/:slug (one segment) |
/:slug |
Regex in source, such as /(.*) or :id(\\d+) |
Not supported; /(.*) is /* |
permanent (default true, sends 308) |
status, default 301. 308 is sent as 301, 307 as 302 |
statusCode |
status |
has / missing |
Not supported, except a country: "conditions": { "Country": [...] } instead of has on x-vercel-ip-country |
headers[].source, headers: [{ key, value }] |
for, values: { key: value } |
rewrites to /index.html from /(.*) |
The SPA mode redirect |
trailingSlash: true / false / unset |
trailingSlash: "always" / "never" / "ignore" |
cleanUrls |
Not supported: a storage zone can’t serve /about.html at /about |
outputDirectory |
outputDir |
Example
{
"redirects": [
{
"source": "/blog/:path*",
"destination": "/news/:path*",
"permanent": true
}
],
"headers": [
{
"source": "/assets/(.*)",
"headers": [
{
"key": "Cache-Control",
"value": "public, max-age=31536000, immutable"
}
]
}
],
"trailingSlash": false
}
becomes, in orbitpush.json:
"redirects": [
{ "from": "/blog/*", "to": "/news/:splat" }
],
"headers": [
{ "for": "/assets/*", "values": { "Cache-Control": "public, max-age=31536000, immutable" } }
],
"trailingSlash": "never"
Note the trailing-slash default: Vercel leaves paths alone unless you set trailingSlash, while orbitpush defaults to always. Set "trailingSlash": "ignore" to keep Vercel’s default behaviour.
3. Deploy and switch DNS
npm run build
npx orbitpush deploy
Check the site on https://<name>.b-cdn.net, then add your domain and point its DNS at bunny.net.