Convex

Was ist Convex?

Convex ist eine reaktive Backend-Plattform, die Datenbank, Serverfunktionen und Clientbibliotheken verbindet. Ihre Abfragen sind TypeScript-Code, der neben der Datenbank läuft; abonnierte Ergebnisse reagieren auf Änderungen gespeicherter Daten.

Die Convex-Echtzeitdatenbank verwendet ein relationales Datenmodell und speichert zugleich JSON-ähnliche Dokumente. Schemas sind optional, Dokumente können auf Dokumente anderer Tabellen verweisen und Anwendungscode liest und schreibt über eine JavaScript-API statt SQL.

Convex bietet auch verwalteten Zugriff auf KI-Modelle über AI Gateway. Der Dienst wird aus Backend-Aktionen aufgerufen; Convex verwahrt die Zugangsdaten der Anbieter, kurzlebige Zugriffstoken sind auf ein Deployment begrenzt.

Kernfunktionen

Abfragen, Mutationen und Aktionen

Die Funktionstypen definieren unterschiedliche Ausführungsgrenzen:

• Abfragen lesen Daten, werden zwischengespeichert und unterstützen reaktive Abonnements.
• Mutationen schreiben Daten und laufen als Datenbanktransaktionen.
• Aktionen rufen externe APIs auf. Sie sind weder transaktional noch zwischengespeichert.
• HTTP-Aktionen stellen Endpunkte für Webhooks oder eigene Clients bereit.

Verwalteter Modellzugriff

AI Gateway bietet Routen für Textgenerierung, Embeddings, Entscheidungen, Bilder, Videos, Spracherzeugung und Transkription. Decisions, Voice sowie Bild- und Videogenerierung sind Alpha-Funktionen; ihre Anfrage- und Antwortformate können sich ändern.

Anleitung

Eine React-Oberfläche verbinden

Ein vorhandenes Convex-Backend verbindet sich über diese Grundelemente mit einer React-Oberfläche:

1. Erstelle für das Deployment einen ConvexReactClient und übergib ihn an einen ConvexProvider, der den Komponentenbaum umschließt.
2. Lies Backend-Daten mit useQuery und dem erzeugten api-Objekt. Der Entwicklungsbefehl erzeugt es in convex/_generated/api.js mit JavaScript-Autovervollständigung und durchgängigen TypeScript-Typen.
3. Ändere Daten mit useMutation. Der Hook gibt eine asynchrone Funktion zurück; ihr Aufruf mit Argumenten führt die Mutation aus.

Convex-Anwendungsfälle

• Live-Chat-Oberflächen: Convex bietet ein Tutorial für eine Echtzeit-Chat-Anwendung mit dauerhaft gespeicherten, live aktualisierten Nachrichten.
• Semantische Suche und Empfehlungen: Die Vektorsuche findet Dokumente ähnlich einem vorgegebenen Vektor. Dokumentierte Anwendungen sind Kontext für LLM-Anwendungen und Empfehlungen verwandter Inhalte.
• Persistente Agenten: Die Agent-Komponente speichert Gesprächsverläufe über Sitzungen hinweg und trennt lang laufende KI-Arbeit von einer reaktiven Oberfläche. Sie unterstützt hybride Vektor-/Textsuche im Verlauf und RAG-basierte Prompt-Erweiterung aus anderen Quellen über die RAG-Komponente oder eine eigene Implementierung.
• Verzögerte und wiederkehrende Arbeit: Geplante Funktionen laufen später einmal, Cron-Jobs wiederholt. Beispiele sind Willkommens-E-Mails und Kontoabgleich; die Komponenten Workpool und Workflow ergänzen Warteschlangen oder dauerhafte Abläufe mit Wiederholungen und Verzögerungen.

Für wen ist es

• JavaScript- und TypeScript-Anwendungsentwickler: Das TypeScript-Backend akzeptiert auch JavaScript; Funktionen werden über Clientbibliothek-APIs bereitgestellt und passen zu Teams, die Oberflächen- und Servercode verantworten.
• Teams mit Wunsch nach Hosting-Betrieb: Convex stellt sein gehostetes Produkt als weniger aufwendig dar; beim Selbsthosting läuft der aktuelle Backend-Code auf eigenen Servern des Teams.

Plattformen

• React-Clients: ConvexReactClient nutzt WebSocket für gepushte Ergebnisse ohne Polling und verbindet sich nach Verbindungsabbruch erneut.
• Frontend-Hosting: Das Frontend kann unabhängig vom Backend-Deployment Vercel, Netlify oder eigenes Hosting nutzen.
• Authentifizierung: Verbindungen und Aufrufe nutzen OpenID-Connect-JWTs. Convex Auth unterstützt clientseitige Registrierungs- und Anmeldeabläufe mit React und React Native, ist aber noch Beta und bietet weniger Funktionen als Drittanbieterintegrationen.
• Datenregionen: Deployments sind in Nord-Virginia, Irland, Sydney oder Kanada Zentral möglich. Nutzung außerhalb der USA kostet 30 % Aufschlag (das 1,3-Fache der Standardtarife).

Die gesamte Infrastruktur eines Deployments wird in der gewählten Region gehostet. Ein Regionswechsel erfordert ein neues Projekt oder Deployment sowie Datenexport/-import; ein bestehendes Deployment lässt sich nicht direkt verschieben.

Preise

Die Preise wurden am 2. November 2026 in USD anhand der angezeigten US-Ost-Basis erfasst. Enthaltene Ressourcen werden regionsübergreifend geteilt.

Tarife und Entwicklerzugang

Business nennt $2,500 monatliches Minimum; Einzelpreise für Deployment-Klasse und Infrastruktur werden separat veröffentlicht. Enterprise nennt Rabatte für Jahresbindung ohne konkreten Rabatt oder jährliche Gesamtsumme.

Ressourcen für Free, Starter und Professional

Jede Zelle nennt enthaltene Menge und Mehrverbrauchstarif. In der ersten Spalte gilt kostenpflichtiger Mehrverbrauch für Starter; Free hat feste Kontingente. Speicher wird pro GB/Monat berechnet, andere Ressourcen nach ihren angegebenen Einheiten.

Serverlose Abfrage-/Mutationsberechnung ist kostenlos. Aufrufe umfassen Clientaufrufe, Zeitpläne, Abonnementaktualisierungen und Dateizugriffe. Dateispeicher umfasst Backups; Ausgang umfasst Funktionsdateizugriff und Backup-Erstellung/-Wiederherstellung. Text-/Vektorindizes und -abfragen teilen ihre jeweiligen Suchzähler.

Die Nutzung wird über Teamprojekte summiert, nicht separat pro Projekt oder Entwickler zugeteilt. Längerer Mehrverbrauch im Free-Tarif kann HTTP-Fehler auslösen; Convex sagt jedoch, erfolgreich geschriebene Mutationsdatensätze würden bei Ressourcenüberschreitung nie gelöscht. Die FAQ nennt Starter und für fortgesetzten Verkehr auch „Starter Plus“. Daraus wird keine separat bepreiste Tarifstufe abgeleitet.

Deployment-Tarife für Business und Enterprise

Die monatliche US-Ost-Tarifmatrix nennt vier Klassen; aktive Deployments werden täglich anteilig berechnet. Andere Einheiten stehen in den Zeilen.

Diese Infrastrukturzähler gelten zusätzlich zur Deployment-Klasse:

Der Gedankenstrich bewahrt den veröffentlichten Wert, ohne Nullpreis oder enthaltenen Anspruch zu unterstellen.

KI-Kosten und Ausgabenkontrolle

AI Gateway erfordert ein zahlendes Team und unterstützt Cloud-Produktions-/Entwicklungsdeployments oder projektgebundene lokale Deployments. Free- und selbstgehostete Deployments können es nicht nutzen; selbstgehostete Aktionen können Anbieter mit eigenen Schlüsseln aufrufen.

Gateway-Kosten hängen von Modell, Zeitpunkt, zwischengespeicherten Token, Bild-/Videoauflösung und -dauer oder Sprachzeichen/-sekunden/-token ab. Sie erscheinen auf der Convex-Rechnung; das Abbrechen einer eingereichten Videoanfrage kann weiterhin Generierungskosten verursachen.

Cloud-Deployments unterstützen tägliche/monatliche AI-Gateway-Abschaltschwellen, die das gesamte Deployment statt nur Modellanfragen abschalten; Deployments außerhalb der Entwicklung unterstützen auch Warnschwellen. Projektgebundene lokale Anfragen teilen das Ausgabenlimit des Teams; laufende Anfragen oder Anfragen mit bereits ausgegebenen kurzlebigen Zugangsdaten können nach Erreichen des Limits abschließen.

Verlängerung und Erstattung

Gebühren sind außer bei ausdrücklichen vertraglichen Ausnahmen nicht kündbar oder erstattbar. Order Forms bestimmen Monats-/Jahreszyklen; Self-Service-Mehrverbrauch wird automatisch berechnet, Zwischenabrechnungen sind bei Erreichen einer Rechnungsschwelle möglich.

Order-Form-Abonnements verlängern sich automatisch um dieselbe Laufzeit, sofern nicht eine Partei mindestens 60 Tage vor Ablauf die Nichtverlängerung mitteilt. Entscheidet sich der Kunde gegen die automatische Verlängerung, geht das Abonnement zu aktuellen Bedingungen und Preisen in eine monatliche Laufzeit über; jede Partei kann sie mit 30 Tagen schriftlicher Vorankündigung beenden.

Behebt Convex einen wesentlichen Vertragsverstoß nicht innerhalb von 30 Tagen nach Erhalt einer schriftlichen Mitteilung darüber, kann der Kunde als nicht vertragsbrüchige Partei die Vereinbarung oder betroffene Order Forms schriftlich kündigen. Kündigt der Kunde die Vereinbarung nach dieser Bestimmung, erstattet Convex anteilig vorausbezahlte, ungenutzte Gebühren für die Restlaufzeit der gekündigten Order Forms zum Wirksamkeitsdatum der Kündigung. Dies ist eine vertragliche Ausnahme, kein allgemeines Testerstattungsfenster.

Convex-Alternativen

Supabase bietet Postgres pro Projekt, Authentifizierung, Speicher mit Row Level Security, Echtzeitdienste und Edge Functions. Die Postgres-Basis macht es für SQL-orientierte Teams zu einer relevanten Alternative.

Firebase Cloud Firestore bietet eine NoSQL-Datenbank für Mobilgeräte, Web und Server mit Echtzeit-Listenern und Offline-Unterstützung für Mobilgeräte und Web. Das dokumentierte Offline-Verhalten ermöglicht Zugriff ohne Verbindung; es belegt kein entsprechendes Verhalten in Convex.

Einschränkungen

Transaktions- und Ausführungsgrenzen

• Externe Seiteneffekte: Aktionen werden bei Fehlern nicht automatisch wiederholt: Eine externe Anfrage könnte bereits gewirkt haben. Aufrufende behandeln Wiederholungen; unerledigte Promises können nach Rückkehr noch abschließen oder auch nicht.
• Getrennte Transaktionen: Aktionen greifen indirekt über Abfragen und Mutationen auf die Datenbank zu. Getrennte runQuery/runMutation-Aufrufe müssen keinen konsistenten Zustand teilen; eine kombinierte Abfrage/Mutation besitzt eine konsistente Transaktionsgrenze.
• Dokumentgröße: Ein Dokument ist auf 1 MiB und eine Verschachtelungstiefe von 16 begrenzt.
• Transaktionsgröße: Eine Abfrage oder Mutation kann höchstens 16 MiB lesen und höchstens 16 MiB schreiben. Gescannte und anschließend weggefilterte Daten zählen weiterhin als Lesevorgänge.

Der Aktionsleitfaden nennt einen Timeout nach 10 Minuten. Die Grenzreferenz nennt dagegen 30 Minuten für Aktionen in Convex-Laufzeit und 10 Minuten in Node-Laufzeit sowie eine Sekunde Abfrage-/Mutationsnutzercode ohne Datenbankoperationen. Diese öffentlichen Angaben sind uneinheitlich.

Grenzen für Suche und Generierung

Vektorsuche ist eine nur für Aktionen verfügbare approximative Suche nächster Nachbarn mittels Kosinusähnlichkeit. Die Zugehörigkeit zu Ergebnissen ist nicht reaktiv, eine separate Abfrage kann aber die Daten jedes Ergebnisses reaktiv halten; Datensätze können sich vor dem Abruf ändern oder verschwinden. Tabellen erlauben vier Vektorindizes mit 2 bis 4.096 Dimensionen.

Bild-/Videogenerierung ist Alpha, Anfrage-/Antwortformate können sich ändern. Bilder nutzen Textprompts, ohne Bearbeitung mit Eingabebild oder Maske. Synchrone Videos schlagen nach etwa fünf Minuten fehl und erlauben 64 MiB Downloads; Abbruch, Timeout oder verlorene Antworten können dennoch Kosten verursachen. Asynchrone Vorgänge laufen nach sieben Tagen ab; Anbieter können Videos kürzer speichern.

Selbsthosting-Lizenz

Die FSL-Apache-2.0-Fair-Source-Lizenz des Backends schließt die Erstellung eines Produkts aus, das für den Wettbewerb mit gehostetem Convex Cloud entworfen ist. Code wechselt zwei Jahre nach Erstellung zu Apache 2.0; aktuelle Versionen sind nicht vom ersten Tag an uneingeschränkt Apache 2.0.

Ausgewiesene Beta Features dienen nur der Bewertung, liegen außerhalb der vertraglichen Platform und haben keine Servicezusagen, keinen Support, keine Gewährleistung oder Haftung für die Nutzung; Convex kann sie einstellen.

Datenrechte und Modellverarbeitung

Kunden/Lizenzgeber behalten Rechte an Customer Data und räumen Convex eine begrenzte Verarbeitungslizenz für Plattformbereitstellung, Wartung/Support/Verbesserung, vom Kunden initiierte Integrationen und gesetzliche Pflichten ein. Dies ist eine Lizenz vom Kunden an die Plattform, keine Übertragung des Dateneigentums.

Convex besitzt Aggregated Data und darf sie für legitime Geschäftszwecke wie Analyse, Produktentwicklung und Benchmarking nutzen. Sie dürfen Kunden/Nutzer nicht identifizieren, deren Informationen nicht in identifizierbarer Form enthalten und eine Reidentifizierung nicht vernünftigerweise ermöglichen.

Die KI-Bedingungen verbieten ohne vorherige schriftliche Kundeneinwilligung das Trainieren/Verbessern von Convex- oder Drittanbieter-Basismodellen mit Customer Data. Ähnliche Eingaben können ähnliche Ausgaben erzeugen; Genauigkeit, Vollständigkeit, Fehlerfreiheit oder Eignung für einen Zweck werden nicht garantiert.

Ein ZDR-Marker dokumentiert eine Übereinstimmung mit dem Zero-Retention-Katalog beim letzten Update. Routing muss pro Anfrage aktiviert werden und schlägt ohne geeigneten Endpunkt fehl; der Marker allein ist keine Garantie. Bild-/Video-/Audiorouten akzeptieren diese Option nicht.

Datenschutz, Löschung und Verarbeitungsorte

Die Datenschutzerklärung von Convex schließt Customer Data von Anwendungen aus; diese unterliegen Kundenvereinbarungen und Anwendungsrichtlinien. Für von der Erklärung erfasste Informationen kann Convex IP-/Gerätekennungen, ungefähren Standort und Aktivitätsdaten erheben und Cookies und Analysetools einsetzen.

Erfasste Informationen können weltweit einschließlich der USA verarbeitet/gespeichert und während der Dienstnutzung oder für Erhebungszwecke, Bereitstellung, Streitigkeiten, Audits, Rechtsverteidigung, Geschäftszwecke, Durchsetzung und gesetzliche Pflichten aufbewahrt werden; eine allgemeine feste Frist wird nicht genannt.

Gemäß DPA muss Convex Customer Personal Data bei Ablauf oder Beendigung der Vereinbarung löschen. Backup-/Archivkopien werden nach seinem Aufbewahrungsplan gelöscht; gesetzlich aufzubewahrende Kopien müssen isoliert und vor weiterer Verarbeitung geschützt werden, außer soweit geltendes Recht sie verlangt. Die Unterauftragsverarbeiterliste ordnet Infrastruktur-/Datenbankdienste der gewählten Region zu und nennt Support, Analyse, Abrechnung und KI-Routing in den USA sowie Community-Management in Deutschland.

Convex nennt AES-256-Verschlüsselung ruhender Kundencodes, Datenbanken, Dateien und Suchindizes, verschlüsselte Übertragung, beschränkten Produktionszugang und SOC-2-Type-2-Konformität. Convex sagt, HIPAA unterliegende Unternehmen dürften PHI auf der Plattform verarbeiten, sofern sie sein Business Associate Agreement unterzeichnen; diese Anbieterangaben belegen nicht die Konformität jeder Kundenanwendung.

FAQ

Q1. Hat jede Convex-Funktion Echtzeit- und Transaktionsgarantien?

Nein. Abfragen werden zwischengespeichert und sind abonnierbar, Mutationen sind transaktional; externe Aktionen erben nicht dieselben Garantien.

Q2. Ist AI Gateway im Free-Tarif enthalten?

Nein. Es erfordert ein zahlendes Team und gesondert gemessene Modellnutzung. Selbstgehostete Deployments nutzen eigene Anbieterzugangsdaten.

Q3. Bedeutet die Wahl einer europäischen Region, dass alle Datenarten dort bleiben?

Nein. Deployment-Infrastruktur, von der Datenschutzerklärung erfasste personenbezogene Daten, Unterauftragsverarbeiter und Aufbewahrung beim Modellrouting haben unterschiedliche Geltungsbereiche.