Web-Apps & Prototypen
4 Min. Lesezeit

Supabase CLI v3: Lokal als Standard. Was in CI und Deploy-Skripten bricht und wie du umsteigst

Bunte Spielzeug-Bausteine: großer Turm vor einer Mauer mit leuchtendem Knopf, daneben ein kleiner Nachbau des Turms
Bild: KI-generiert
Kurz gesagt

Seit 2. November 2026 installieren npm, Scoop und die GitHub Action von Supabase die CLI v3. Sie arbeitet ohne Angabe gegen die lokale Datenbank und bricht Änderungen am Live-Projekt in Pipelines ab, solange kein --yes dabei ist. Wer CI oder Deploy-Skripte nutzt, sollte heute v2 pinnen und den Umstieg geplant testen.

Supabase hat am 2. November 2026 die CLI v3.0.0 veröffentlicht, den Changelog-Eintrag als Breaking Change gab es am 4. November. Die CLI ist das Kommandozeilenwerkzeug, mit dem du Datenbank-Migrationen, Edge Functions und Secrets von deinem Rechner oder aus einer Pipeline zu Supabase bringst. Deine gehosteten Projekte und ihre Daten ändert das Update nicht. Es ändert, was deine Skripte tun.

Was ändert sich mit der Supabase CLI v3?

Die CLI arbeitet jetzt standardmäßig gegen die lokale Entwicklungsumgebung und fragt vor jeder Änderung am Live-Projekt nach. Die wichtigsten Punkte laut Changelog:

  • Lokal als Standard: db push, db pull, db dump, migration list, gen types und die storage-Befehle zielen auf die lokale Datenbank, solange du nicht --remote angibst.
  • Ein Flag statt drei: --remote ersetzt --linked, --project-ref und --db-url. Die alten Flags laufen noch, --project-ref fällt laut Migrationsleitfaden mit v4 weg.
  • Rückfrage mit Standard Nein: Jeder Befehl, der ein gehostetes Projekt verändert, fragt vorher. Ohne Terminal, also in CI (der automatischen Pipeline etwa in GitHub Actions), bricht er ab, außer du setzt --yes. Ein vorgeschaltetes echo y zählt nicht mehr.
  • Entfernte Befehle: Alte Befehle, Flags und Konfigurationsschlüssel enden mit Fehlercode 1 und nennen den Ersatz. Aus [inbucket] in der config.toml wird [local_smtp].
  • Neue Diff-Engine: pg-delta erzeugt jetzt das SQL bei db diff und db pull. Generierte Migrationen können anders aussehen als bisher.

Warum trifft es dich vielleicht schon beim nächsten Lauf?

Weil die Installationswege v3 ohne dein Zutun ausliefern. npm, Scoop, die Linux-Pakete und die Action supabase/setup-cli liefern seit 2. November v3, Homebrew seit 3. November. Die Action installiert ohne version-Angabe v3, außer ein Lockfile im Wurzelordner des Repos (package-lock.json, pnpm-lock.yaml oder bun.lock) legt die Version fest, so der Leitfaden. Wer npx supabase ohne feste Version aufruft, bekommt beim nächsten Lauf die neue Hauptversion.

Welche Fehler fallen nicht sofort auf?

Die lauten Fehler sind harmlos: HostedMutationConsentRequiredError bei functions deploy, secrets set, config push oder db push siehst du im Log. Gefährlich sind drei stille Fälle:

Fall Was passiert Lösung
db push ohne --remote Läuft gegen die lokale Datenbank. Startet deine Pipeline für Tests eine lokale Umgebung, ist der Job grün, die Live-Datenbank bleibt alt db push --yes --remote
SUPABASE_YES=1 in einer .env Zählt nur als Export in der Shell. Steht der Name in .env, .env.local oder einer umgebungsspezifischen Datei wie .env.production im Arbeitsordner, wird sogar der Shell-Export ignoriert --yes direkt am Befehl
Remote-Blöcke wie [remotes.staging] plus SUPABASE_*-Variablen Die Variablen überstimmen jetzt den Block, und config push schickt ihre Werte ans Projekt Vor dem ersten config push supabase config diff

Dazu kommt eine Kleinigkeit mit großer Wirkung: secrets unset löscht nur noch mit --all alle Secrets auf einmal. Und laut Release Notes schaltet enable_confirmations = false unter [auth.sms] beim config push jetzt wirklich die Telefon-Bestätigung ab. Steht das in deiner Datei, ändert sich dein Login-Ablauf.

Was heißt das für KI-Coding-Agenten?

Agenten wie Claude Code oder Codex bekommen nie eine Rückfrage, auch nicht im Terminal. Die Fehlermeldung sagt dem Agenten, dass er dich fragen soll, bevor er --yes ergänzt. Unsere Einschätzung: Das ist die beste Neuerung des Releases. Bisher brauchte ein Agent für eine Änderung am Live-Projekt keine Bestätigung. Die Sperre bringt aber nur etwas, wenn niemand --yes pauschal in Skripte oder Agent-Anweisungen schreibt. Gib es nur dem Deploy-Schritt in der Pipeline, nicht dem Agenten. Mehr zu Risiken bei KI-gebauten Apps steht in unserem Artikel zu Vibe Coding.

Solltest du upgraden oder bei v2 bleiben?

Heute pinnen, in Ruhe umsteigen. v2 bekommt laut Changelog weiter Sicherheitsfixes und Fehlerbehebungen, aber keine neuen Funktionen. Ein Enddatum nennt Supabase nicht. So hältst du v2 fest:

  • npm: npm install supabase@v2.stable --save-dev
  • Homebrew: brew install supabase/tap/supabase@2
  • Scoop: scoop install supabase-v2-stable
  • GitHub Actions: version: v2.stable bei supabase/setup-cli@v3

Der Umstieg in der Reihenfolge, die Supabase empfiehlt:

  1. Auf die neueste v2 gehen und alle Abläufe inklusive CI laufen lassen. Ab v2.122.0 warnt die CLI vor allem, was in v3 bricht. Jede Warnung beheben.
  2. [inbucket] in supabase/config.toml in [local_smtp] umbenennen, auch in Remote-Blöcken wie [remotes.staging.inbucket].
  3. --remote an alle Befehle, die das Live-Projekt erreichen sollen, --yes an unbeaufsichtigte Live-Änderungen.
  4. SUPABASE_*-Variablen in CI und .env-Dateien prüfen, dann supabase config diff.
  5. Fehlt project_id in der config.toml: vorher supabase stop, weil sich Container-Namen ändern können.
  6. v3 installieren und den ersten Deploy gegen ein Testprojekt oder einen Branch fahren, nicht gegen Produktion.

Was heißt das für dein Unternehmen?

Betroffen ist, wer Supabase über Skripte, Pipelines oder Agenten anspricht. Wer seine App nur in Lovable oder im Supabase-Dashboard pflegt und die CLI nie nutzt, muss nichts tun. Lässt eine Agentur oder ein Freelancer deine Web-App automatisch deployen, frag diese Woche nach, ob die Version gepinnt ist. Nach dem Umstieg reicht ein Kontrollblick: Ist die letzte Migration wirklich in der Live-Datenbank angekommen? Das ist der Punkt, den ein grüner Haken in v3 nicht mehr garantiert. Wie Kunden deine Supabase-App aus ChatGPT oder Claude nutzen, zeigt unser Beitrag zum Supabase MCP Server. Und wenn du Hilfe bei Web-Apps mit Supabase brauchst: hier geht es zu unseren Leistungen.

Häufige Fragen

Ändert die Supabase CLI v3 etwas an meinem gehosteten Projekt oder meinen Daten?

Nein. Laut Supabase sind gehostete Projekte, ihre Daten und selbst gehostetes Supabase nicht betroffen. Es ändert sich nur, wie die CLI Befehle ausführt.

Wie erkenne ich, welche Version meine Pipeline gerade nutzt?

Schau im Log des Installationsschritts deiner Pipeline nach, welche Version installiert wurde. Steht dort 3.x, läuft bereits v3, auch wenn du an der Pipeline nichts geändert hast.

Kann ich SUPABASE_YES statt --yes verwenden?

Ja, aber nur als Export in der Shell. In supabase/.env zählt es nicht, und definiert eine .env-Datei im Arbeitsordner die Variable, ignoriert die CLI auch den Shell-Export. --yes am Befehl ist der sichere Weg.

Wie lange bekommt die CLI v2 noch Updates?

Supabase nennt kein Enddatum. v2 bekommt Sicherheitsfixes und Fehlerbehebungen, aber keine neuen Funktionen, deshalb lohnt der geplante Umstieg.

Quellen

  1. Supabase: Breaking Change: Supabase CLI v3 is local by default and confirms hosted changes
  2. Supabase Docs: Migrating to Supabase CLI v3
  3. GitHub supabase/cli: Release v3.0.0
Dieser Artikel wurde mit KI erstellt.
Du hast ein Projekt im Kopf?

Schreib uns, was du vorhast. Innerhalb von 24 Stunden bekommst du eine ehrliche Einschätzung.

Top, das hat geklappt. Wir sind gespannt!
Whoopsie! Hier ist irgendwas total schiefgelaufen... Vielleicht doch besser einfach eine mail? Sorry!
Oder direkt per Mail: hi@blocksandcolors.de