Supabase– mit Docker Compose und Traefik installieren

6. Starten und Stoppen von Supabase

Jetzt kannst du mit folgendem Befehl im gleichen Verzeichnis wie deine docker-compose.yml-Datei den ganzen Supabase-Stack hochfahren:

<em># Start the services (in detached mode)</em>
docker compose up -dCode-Sprache: HTML, XML (xml)

Wenn alle Services gestartet sind, kannst du sie wie folgt überprügen:

docker compose ps

Nach maximal einer Minute sollten alle Dienste den Status Up [...] (healthy) haben. Wenn du einen Status wie created, aber nicht Up siehst, überprüfe die Docker-Protokolle für einen bestimmten Container, z. B.

docker compose logs analytics

Um Supabase wieder zu beenden, benutze:

docker compose down

7. Supabase verwenden

Nachdem die Supabase-Dienste konfiguriert wurden und laufen, kannst du auf das Dashboard zugreifen, eine Verbindung zur Datenbank herstellen und Edge-Funktionen nutzen.

7.1. Supabase Studio anzeigen

Du kannst über das API-Gateway auf Port 8000 auf Supabase Studio zugreifen.

Beispiel: https://supabase.deinedomain.de:8000

Du wirst zur Eingabe eines Benutzernamens und eines Passworts aufgefordert. Verwende die Anmeldedaten, die du zuvor in der Studio-Authentifizierung eingerichtet haben.

7.2. Zugriff auf Postgres

Standardmäßig stellt der Supabase-Stack den Supavisor-Verbindungspooler für den Zugriff auf Postgres und die Verwaltung von Datenbankverbindungen bereit.

Du kannst dich über Supavisor mit der Postgres-Datenbank verbinden, indem du die unten beschriebenen Methoden verwendest. Verwende dabei deinen Domainnamen.

Die Standard-POOLER_TENANT_ID ist your-tenant-id (kann in .env geändert werden), und das Passwort ist dasjenige, das du zuvor unter Datenbankpasswort konfigurieren festgelegt hast.

Für sitzungsbasierte Verbindungen (entspricht einer direkten Postgres-Verbindung):

psql ‚postgres://postgres.[POOLER_TENANT_ID]:[POSTGRES_PASSWORD]@[your-domain]:5432/postgres‘Code-Sprache: JavaScript (javascript)

Für gepoolte Transaktionsverbindungen:

psql ‚postgres://postgres.[POOLER_TENANT_ID]:[POSTGRES_PASSWORD]@[your-domain]:6543/postgres‘Code-Sprache: JavaScript (javascript)

Wenn du psql mit Befehlszeilenparametern anstelle einer Verbindungszeichenfolge verwendest, um eine Verbindung zu Supavisor herzustellen, sollte der Parameter -U ebenfalls postgres.[POOLER_TENANT_ID] lauten und nicht nur postgres.

Wenn du Postgres so konfigurieren musst, dass es direkt über das Internet zugänglich ist, lese dazu Exposing your Postgres database.

Um das Datenbankpasswort zu ändern, lese Changing database password.

7.3. Zugriff auf Edge Functions

Edge-Funktionen werden in volumes/functions gespeichert. Die Standardeinstellung enthält eine hello-Funktion, die du unter

https://supabase.deinedomain.de:8000/functions/v1/hello

aufrufen kannst.

Du kannst neue Funktionen als volumes/functions/<FUNCTION_NAME>/index.ts hinzufügen. Starte den Dienst functions neu, um die Änderungen zu übernehmen:

<code>docker compose restart functions --no-deps</code>Code-Sprache: HTML, XML (xml)

7.4. Zugriff auf die APIs

Jede API über das gleiche API-Gateway erreichbar:

• REST: https://supabase.deinedomain.de:8000/rest/v1/
• Auth: https://supabase.deinedomain.de:8000/auth/v1/
• Storage: https://supabase.deinedomain.de:8000/storage/v1/
• Realtime: https://supabase.deinedomain.de:8000/realtime/v1/

8. Supabase updaten

We publish stable releases of the Docker Compose setup approximately once a month. To update, apply the latest changes from the repository and restart the services. If you want to run different versions of individual services, you can change the image tags in the Docker Compose file, but compatibility is not guaranteed. All Supabase images are available on Docker Hub.

To follow the changes and updates, refer to the self-hosted Supabase changelog.

You need to restart services to pick up the changes, which may result in downtime for your applications and users.

Example: You’d like to update or rollback the Studio image. Follow the steps below:

1. Check the supabase/studio images on Supabase Docker Hub
2. Find the latest version (tag) number. It looks something like 2025.11.26-sha-8f096b5
3. Update the image field in the docker-compose.yml file. It should look like this: image: supabase/studio:2025.11.26-sha-8f096b5
4. Run docker compose pull, followed by docker compose down && docker compose up -d to restart Supabase.

Supabase veröffentlicht etwa einmal im Monat stabile Versionen des Docker Compose-Setups. Um ein Update durchzuführen, wende die neuesten Änderungen aus dem Repository an und starten die Dienste neu. Wenn du verschiedene Versionen einzelner Dienste ausführen möchtest, kannst du die Image-Tags in der Docker Compose-Datei ändern, jedoch kann die Kompatibilität nicht garantiert werden. Alle Supabase-Images sind auf Docker Hub verfügbar.

Um die Änderungen und Updates zu verfolgen, lese das Changelog für selbst gehostete Supabase-Installationen.

Du musst die Dienste neu starten, um die Änderungen zu übernehmen, was zu Ausfallzeiten für deine Anwendungen und Benutzer führen kann.

Beispiel: Du möchtest das Studio-Image aktualisieren oder zurücksetzen. Befolge die folgenden Schritte:

1. Überprüfe die supabase/studio-Images auf Supabase Docker Hub
2. Suche die Nummer der neuesten Version (Tag). Sie sieht in etwa so aus: 2025.11.26-sha-8f096b5
3. Aktualisiere das Feld „image” in der Datei „docker-compose.yml”. Es sollte wie folgt aussehen: „image: supabase/studio:2025.11.26-sha-8f096b5
4. Führen „docker compose pull” aus, gefolgt von „docker compose down && docker compose up -d”, um Supabase neu zu starten.

Für alle weiteren Fragen verfügt Supabase über eine sehr gute Dokumentation.