Skip to content
orbitpush

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.