Docs

CLI: Import from Supabase or Firebase

Move a Supabase or Firebase project to Sovaria with sov import: schema and row-level security, users with their passwords, data, documents, storage, and a report of what needs a look.

Updated Oct 17, 2026

Run with --dry-run first: everything is read and checked, nothing is written. Every run writes sovaria-import-report.json. Step by step: Migrate from Supabase or Firebase.

sov import supabase \
  --db-url 'postgresql://postgres:PASSWORD@db.REF.supabase.co:5432/postgres' \
  --supabase-url https://REF.supabase.co --service-key "$SUPABASE_SERVICE_ROLE_KEY" --dry-run

sov import

Import a Supabase or Firebase project

sov import supabase

Import a Supabase project: schema + RLS, users with passwords, data, storage.

sov import supabase [OPTIONS]

Arguments and options

--db-urltextrequired
Supabase Postgres connection string (Settings › Database)
--supabase-urltextoptional
https://<ref>.supabase.co (for storage)
--service-keytextoptional
Supabase service_role key (for storage)
--onlytextoptional
Comma list: schema,auth,data,storage
--schematextoptionaldefault public
Schema to copy
--rows-per-insertint rangeoptionaldefault 50
--dry-runflagoptional
Check everything, write nothing to Sovaria
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov import firebase

Import a Firebase project: Auth users with passwords, Firestore, Storage, and a rules report.

sov import firebase [OPTIONS]

Arguments and options

--service-accountpathoptional
Service account JSON (Firestore + Storage read)
--auth-exportpathoptional
File from: firebase auth:export users.json --format=json
--hash-configpathoptional
JSON with base64_signer_key, base64_salt_separator, rounds, mem_cost
--rulespathoptional
firestore.rules: writes a report of Sovaria equivalents
--storage-buckettextoptional
GCS bucket (default <project>.appspot.com)
--to-buckettextoptionaldefault firebase-storage
Sovaria bucket for Firebase Storage objects
--onlytextoptional
Comma list: auth,firestore,storage,rules
--remap-uids / --keep-uidsflagoptional
Replace Firebase uids in documents with Sovaria user ids
--dry-runflagoptional
Read everything, write nothing to Sovaria
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.
Something unclear or missing on this page?Tell us