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.
Pick your starting point
Section titled “Pick your starting point”| 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 D1 | From Cloudflare Workers + D1 |
| An Amazon S3, Cloudflare R2, MinIO, Vultr, or other S3-compatible bucket | From 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.
The shape of every migration
Section titled “The shape of every migration”An application migration has four core moves, plus an object move when needed:
- Build for brrrd — add
@brrrd/adapterto your Next config and build. The adapter emits a deployable package (dist/brrrd). - Provision or import a database — create a Louhi database with
comwit databases create, or for D1/SQLite/Turso data, export a SQL dump and usecomwit databases import-dumpto create a new Louhi database from it. - Point your app at it — for D1 apps, swap the database client to libSQL;
set
DATABASE_URL/DATABASE_AUTH_TOKEN. - Deploy —
comwit apps createthencomwit deploy --package ./dist/brrrd, optionally binding a custom hostname. - Move object data when used — create Comwit Storage, copy and verify the source inventory, then switch the S3 endpoint, project token, and public URL.
Before you start
Section titled “Before you start”- Install and sign in to the
comwitCLI — 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).
What you get afterward
Section titled “What you get afterward”- App served on the brrrd runtime, reachable on a Comwit hostname (or your own domain — see Custom hostnames and Connect a domain to an app).
- A libSQL database on Louhi with rotatable tokens (Manage a database).
- Deploys you can automate from CI (CI/CD).
- Project-owned S3-compatible buckets with direct public delivery (Storage overview).