Du entscheidest, welche Dienste wir zur Analyse, Personalisierung und für externe Inhalte aktivieren dürfen.
Wir verwenden Cookies und ähnliche Technologien auf unserer Website, um Inhalte zu personalisieren, externe Medien einzubinden und die Nutzung einzelner Bereiche besser zu verstehen.
Notwendige Cookies
Diese Einträge sichern Grundfunktionen wie Sicherheit, Stabilität und Formularverarbeitung.
Optionale Bereiche
AnalyseMarketingPersonalisierungExterne Medien
Die Datenverarbeitung kann mit deiner Einwilligung oder auf Basis berechtigter Interessen erfolgen. In den Cookie-Einstellungen kannst du jeder optionalen Kategorie widersprechen oder sie gezielt freigeben.
Einige Services verarbeiten personenbezogene Daten in Drittländern. Mit deiner Einwilligung akzeptierst du auch diese Übermittlung. Weitere Informationen findest du in unserer Datenschutzerklärung.
Deine Auswahl kann später jederzeit erneut geöffnet und angepasst werden. · 1.0.2
Supabase auf einem Windows Server einrichten: WSL2 mit Ubuntu installieren, Docker darin einrichten, Supabase starten und von außen erreichbar machen → Jetzt mehr erfahren
3. November 20265 Min. Lesezeit3 Aufrufe0 hilfreich
Einführung
Supabase ist eine Open-Source-Postgres-Entwicklungsplattform, die eine vollständige Postgres-Datenbank plus Authentifizierung, sofortige APIs, Echtzeit und Storage bietet – eine Open-Source-Alternative zu Firebase.
Supabase besteht aus mehreren Linux-Containern. Auf einem Windows Server laufen diese Container nicht direkt, sondern in einem Linux-System, das du mit dem Windows-Subsystem für Linux (WSL2) einrichtest. In dieser Anleitung zeigen wir dir, wie du WSL2 mit Ubuntu installierst, darin Docker einrichtest und Supabase startest.
Tipp
Einfacher geht es mit einem Linux vServer
Auf einem Linux vServer (Debian oder Ubuntu) installierst du Supabase mit wenigen Klicks über One-Click Apps im vServer-Webinterface oder manuell nach unserer Anleitung Supabase auf einem Linux Server einrichten. Das ist der von uns empfohlene Weg: Unter Windows läuft für WSL2 zusätzlich eine eigene virtuelle Maschine in deinem vServer, die Arbeitsspeicher und CPU belegt und mehr Pflege braucht. One-Click Apps sind auf Windows vServern nicht verfügbar.
Voraussetzungen
Bevor du Supabase installierst, stelle sicher, dass deine Hosting-Umgebung folgende Anforderungen erfüllt. Windows und die WSL2-Umgebung brauchen zusätzlich zu Supabase eigene Ressourcen.
Hardware
Minimum
ZAP-Hosting Empfehlung
CPU
2 vCPU Kerne
4 vCPU Kerne
RAM
8 GB
16 GB
Festplattenspeicher
60 GB
80 GB
Betriebssystem: Windows Server 2022 oder Windows Server 2025
Abhängigkeiten:WSL2 mit Ubuntu 24.04, darin Git und Docker (Engine und Compose)
Achtung
Kein Docker Desktop und keine Windows-Container
Docker Desktop wird von Docker auf Windows Server nicht unterstützt. Die Docker Engine aus unserer Anleitung Docker auf einem Windows Server einrichten führt nur Windows-Container aus und eignet sich deshalb nicht für Supabase. Installiere Docker wie unten beschrieben innerhalb von Ubuntu in WSL2.
FAQ
Häufig gestellte Fragen
Supabase läuft als Linux-Container. Auf einem Windows Server 2022 oder 2025 installierst du dafür zuerst WSL2 mit Ubuntu, richtest darin Docker Engine und Docker Compose ein und startest Supabase anschließend mit docker compose. One-Click Apps gibt es nur auf Linux vServern.
Supabase ist eine Open-Source-Postgres-Entwicklungsplattform, die eine vollständige Postgres-Datenbank plus Authentifizierung, sofortige APIs, Echtzeit und Storage bietet – eine Open-Source-Alternative zu Firebase.
Weil Windows und die WSL2-Umgebung zusätzlich Ressourcen brauchen, solltest du mindestens 2 vCPU-Kerne, 8 GB RAM und 60 GB Festplattenspeicher einplanen. ZAP-Hosting empfiehlt 4 vCPU-Kerne, 16 GB RAM und 80 GB Festplattenspeicher.
Nein. Docker Desktop wird auf Windows Server nicht unterstützt, und die Docker Engine für Windows führt nur Windows-Container aus. Installiere Docker stattdessen innerhalb von Ubuntu in WSL2.
Ja. Auf einem Linux vServer mit Debian oder Ubuntu installierst du Supabase mit wenigen Klicks über One-Click Apps im vServer-Webinterface. Das ist der von uns empfohlene Weg.
Feedback
War dieser Artikel hilfreich?
Deine Rückmeldung hilft uns, Inhalte besser zu priorisieren und zu überarbeiten.
0 von 0 Rückmeldungen fanden diesen Artikel hilfreich.
Persönliche Hilfe
Die Anleitung reicht nicht?
Unser ZAP-Support kennt dein Produkt — beschreib kurz dein Anliegen und wir helfen dir persönlich weiter.
Navigation
Software
Vorbereitung
WSL2 und Ubuntu installieren
Verbinde dich per Remotedesktop (RDP) als Administrator mit deinem Server. Öffne die PowerShell als Administrator und installiere WSL2 zusammen mit Ubuntu 24.04:
Code
wsl --install -d Ubuntu-24.04
Starte den Server danach neu. Nach dem Neustart öffnest du erneut die PowerShell und startest Ubuntu einmal mit wsl -d Ubuntu-24.04. Beim ersten Start legst du einen Linux-Benutzernamen und ein Passwort fest.
Info
Die Meldung Nested virtualization is not supported on this machine kann beim Start erscheinen. Sie betrifft nur virtuelle Maschinen innerhalb von WSL und hat für Supabase keine Auswirkung.
Mit wsl -l -v prüfst du, ob Ubuntu läuft und die Version 2 verwendet.
System aktualisieren
Alle folgenden Befehle führst du in der Ubuntu-Konsole aus (wsl -d Ubuntu-24.04). Bringe zuerst die Pakete auf den neuesten Stand und installiere Git:
Beende die Ubuntu-Konsole mit exit, führe in der PowerShell wsl --shutdown aus und öffne Ubuntu danach wieder, damit die Gruppenmitgliedschaft greift. Mit docker version und docker compose version prüfst du die Installation.
Eine ausführliche Anleitung zur Nutzung von Docker unter Linux findest du in unserer Docker Anleitung.
Installation
Wenn alle Voraussetzungen erfüllt sind, kannst du Supabase installieren. Lade in der Ubuntu-Konsole das Supabase-Repository, erstelle ein eigenes Projektverzeichnis und kopiere die Docker-Dateien und die Beispiel-Umgebungsdatei hinein:
Wechsle in das Projektverzeichnis, lade die aktuellen Container-Images und starte den Stack im Hintergrund:
Code
cd supabase-project
docker compose pull
docker compose up -d
Auf dem Server selbst erreichst du Supabase Studio jetzt im Browser über http://localhost:8000. Es wird nach Benutzername und Passwort gefragt. Standardmäßig sind die Zugangsdaten:
Standard-Zugangsdaten
Deine App läuft jetzt mit den Standard-Zugangsdaten. Ändere sie wie im Abschnitt Konfiguration beschrieben, bevor du Supabase von außen erreichbar machst.
Supabase von außen erreichbar machen
WSL2 hat ein eigenes, internes Netzwerk. Damit Supabase Studio und die API über die IP-Adresse deines Servers erreichbar sind, leitest du den Port von Windows an WSL weiter. Ermittle zuerst die interne IP-Adresse von Ubuntu in der PowerShell:
Code
wsl -d Ubuntu-24.04 hostname -I
Richte danach die Weiterleitung und eine Firewall-Regel ein. Ersetze [WSL-IP] durch die erste angezeigte Adresse:
Supabase Studio erreichst du nun über http://[deine-ip]:8000.
Info
Die interne IP-Adresse von WSL kann sich nach einem Neustart ändern. Prüfe sie dann erneut und passe die Weiterleitung mit netsh interface portproxy set v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP] an.
Supabase dauerhaft laufen lassen
WSL beendet Ubuntu, sobald kein Fenster und kein Befehl mehr darauf zugreift. Damit Supabase weiterläuft, legst du in Windows die Datei C:\Users\<Benutzername>\.wslconfig mit folgendem Inhalt an:
Führe danach in der PowerShell wsl --shutdown aus und starte Ubuntu neu. Die Supabase-Container starten automatisch mit, sobald Docker in Ubuntu läuft.
Damit Supabase auch nach einem Neustart des Servers wieder startet, legst du in der Aufgabenplanung eine Aufgabe an, die beim Systemstart unter deinem Administrator-Konto ausgeführt wird (Option Unabhängig von der Benutzeranmeldung ausführen). Als Aktion trägst du wsl.exe mit den Argumenten -d Ubuntu-24.04 -u root -- systemctl start docker ein.
Konfiguration
Du solltest niemals mit Standard- oder Beispielwerten live gehen. Ersetze alle Platzhalter durch starke, einzigartige Secrets, überprüfe die Konfiguration auf deine Sicherheitsanforderungen und starte alle Services neu, damit die Änderungen greifen.
Generiere sichere API-Keys, bevor du einen Service öffentlich machst. Starte mit einem 40-stelligen JWT-Secret. Du kannst den vorgegebenen Wert nutzen oder dein eigenes erstellen. Speichere das Secret lokal an einem sicheren Ort. Teile es nicht und committe es nicht in Versionskontrollen. Nutze das Secret, um ein JWT zu generieren und daraus die anon- und service-API-Keys mit dem Formular aus den Supabase-Dokumenten abzuleiten: https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys
Führe das Formular zweimal aus, um beide Keys zu erzeugen. Aktualisiere die Datei .env in deinem Projektverzeichnis ~/supabase-project mit:
ANON_KEY: anon key
SERVICE_ROLE_KEY: service key
Setze die erforderlichen Secrets in derselben .env. Diese Werte müssen für eine funktionierende Installation gesetzt sein:
POSTGRES_PASSWORD: Passwort für die Rolle postgres
JWT_SECRET: wird von PostgREST und GoTrue genutzt
SITE_URL: Basis-URL deiner Seite
SMTP_*: Zugangsdaten für deinen Mailserver
POOLER_TENANT_ID: Tenant-ID, die vom Supavisor Pooler genutzt wird
Schütze das Dashboard mit neuen Zugangsdaten vor dem Produktiveinsatz. Bearbeite dazu ebenfalls die .env:
DASHBOARD_USERNAME: Dashboard-Benutzername
DASHBOARD_PASSWORD: Dashboard-Passwort
Du kannst mehrere Dashboard-Nutzer in volumes/api/kong.yml im Projektverzeichnis definieren:
Um alle Dashboard-Funktionen auch außerhalb von localhost zu nutzen, setze SUPABASE_PUBLIC_URL in der .env auf die URL oder IP, über die du das Dashboard erreichen willst.
Wende die Konfigurationsänderungen an, indem du den Stack im Projektverzeichnis neu startest:
Code
docker compose down
docker compose up -d
Fazit und weitere Ressourcen
Glückwunsch! Du hast Supabase jetzt erfolgreich auf deinem Windows Server mit WSL2 installiert und konfiguriert. Wir empfehlen dir außerdem, einen Blick auf diese Ressourcen zu werfen, die dir bei der Serverkonfiguration weiterhelfen können:
Du hast spezielle Fragen, die hier nicht beantwortet werden? Für weitere Fragen oder Support steht dir unser Team täglich zur Verfügung – melde dich einfach bei uns! 🙂
Server-Hosting ab 2,49 €/Mo., sofort online, DDoS-Schutz inklusive.
Bevorzugte Quelle bei Google
