Skip to content

Migrate to Comwit Cloud

These guides move an existing application and its data onto Comwit Cloud: apps run on brrrd, databases live on Louhi, and object buckets become Comwit Storage. They are concrete runbooks a coding agent can execute.

You are on…Follow
A Next.js app (any host, no Cloudflare coupling)From Next.js (15 & 16)
A Next.js app on Cloudflare Workers/Pages using D1From Cloudflare Workers + D1
An Amazon S3, Cloudflare R2, MinIO, Vultr, or other S3-compatible bucketFrom S3, R2, or compatible storage

If you have Cloudflare and D1, use the Cloudflare guide — it includes the database move. If you are on Cloudflare but use an external database (not D1), follow the Next.js guide for the runtime and just point your existing database connection string at your app’s environment.

An application migration has four core moves, plus an object move when needed:

  1. Build for brrrd — add @brrrd/adapter to your Next config and build. The adapter emits a deployable package (dist/brrrd).
  2. Provision or import a database — create a Louhi database with comwit databases create, or for D1/SQLite/Turso data, export a SQL dump and use comwit databases import-dump to create a new Louhi database from it.
  3. Point your app at it — for D1 apps, swap the database client to libSQL; set DATABASE_URL / DATABASE_AUTH_TOKEN.
  4. Deploy — comwit apps create then comwit deploy --package ./dist/brrrd, optionally binding a custom hostname.
  5. Move object data when used — create Comwit Storage, copy and verify the source inventory, then switch the S3 endpoint, project token, and public URL.
  • Install and sign in to the comwit CLI — see Install the CLI & sign in.
  • Know your project id (comwit projects list). Everything is created under a project.
  • Node + your package manager (the examples use pnpm; npm/yarn work too).