Supabase je open-source vývojová platforma pro Postgres, která nabízí kompletní databázi Postgres a také ověřování, okamžitá API, funkce v reálném čase a úložiště – open-source alternativu k Firebase.
Supabase se skládá z několika linuxových kontejnerů. Na Windows serveru tyto kontejnery neběží přímo, ale v linuxovém systému, který nastavíš pomocí Subsystému Windows pro Linux (WSL2). V tomto návodu ti ukážeme, jak nainstalovat WSL2 s Ubuntu, nastavit v něm Docker a spustit Supabase.
Jednodušší je to s Linuxovým VPS Na Linuxovém VPS (Debian nebo Ubuntu) nainstaluješ Supabase několika kliknutími přes One-Click Apps ve webovém rozhraní VPS serveru nebo ručně podle našeho návodu Jak nastavit Supabase na Linux serveru. Tuto možnost doporučujeme: Ve Windows běží pro WSL2 ve tvém VPS navíc vlastní virtuální stroj, který využívá paměť RAM a CPU a vyžaduje více péče. One-Click Apps nejsou na Windows VPS serverech dostupné.
Než Supabase nainstaluješ, ujisti se, že tvoje hostingové prostředí splňuje následující požadavky. Windows a prostředí WSL2 potřebují kromě Supabase i vlastní prostředky.
| Hardware | Minimum | Doporučení ZAP-Hosting |
|---|---|---|
| CPU | 2 jádra vCPU | 4 jádra vCPU |
| RAM | 8 GB | 16 GB |
| Místo na disku | 60 GB | 80 GB |
Operační systém: Windows Server 2022 nebo Windows Server 2025
Závislosti: WSL2 s Ubuntu 24.04, v něm Git a Docker (Engine und Compose)
Žádný Docker Desktop ani kontejnery Windows Docker Desktop není podle Dockeru ve Windows Serveru podporován. Docker Engine z našeho návodu Jak nastavit Docker na Windows serveru spouští pouze kontejnery Windows, a proto se pro Supabase nehodí. Nainstaluj Docker podle následujících pokynů přímo v Ubuntu ve WSL2.
Připoj se k serveru přes Vzdálenou plochu (RDP) jako správce. Otevři PowerShell jako správce a nainstaluj WSL2 společně s Ubuntu 24.04:
wsl --install -d Ubuntu-24.04
Potom server restartuj. Po restartu znovu otevři PowerShell a jednou spusť Ubuntu pomocí wsl -d Ubuntu-24.04. Při prvním spuštění vytvoř uživatelské jméno a heslo pro Linux.
Při spuštění se může zobrazit zpráva Nested virtualization is not supported on this machine. Týká se pouze virtuálních strojů uvnitř WSL a Supabase nijak neovlivňuje.
Pomocí wsl -l -v zkontroluješ, jestli Ubuntu běží a používá verzi 2.
Všechny následující příkazy spusť v konzoli Ubuntu (wsl -d Ubuntu-24.04). Nejdřív aktualizuj balíčky a nainstaluj Git:
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl
Nainstaluj Docker Engine včetně Docker Compose pomocí oficiálního instalačního skriptu Dockeru:
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
Ukonči konzoli Ubuntu příkazem exit, v PowerShellu spusť wsl --shutdown a potom znovu otevři Ubuntu, aby se změna členství ve skupině projevila. Instalaci ověříš pomocí docker version a docker compose version.
Podrobný návod k používání Dockeru v Linuxu najdeš v našem návodu Docker.
Jakmile splníš všechny požadavky, můžeš nainstalovat Supabase. V konzoli Ubuntu stáhni repozitář Supabase, vytvoř vlastní projektovou složku a zkopíruj do ní soubory Dockeru a ukázkový soubor prostředí:
cd ~
git clone --depth 1 https://github.com/supabase/supabase
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env
Přejdi do projektové složky, stáhni aktuální obrazy kontejnerů a spusť celý stack na pozadí:
cd supabase-project
docker compose pull
docker compose up -d
Přímo na serveru teď otevřeš Supabase Studio v prohlížeči na adrese http://localhost:8000. Zobrazí se výzva k zadání uživatelského jména a hesla. Výchozí přihlašovací údaje jsou:
- Uživatelské jméno:
supabase - Heslo:
this_password_is_insecure_and_should_be_updated
Výchozí přihlašovací údaje Aplikace teď běží s výchozími přihlašovacími údaji. Než Supabase zpřístupníš zvenčí, změň je podle pokynů v části Konfigurace.
WSL2 má vlastní interní síť. Aby bylo možné Supabase Studio a API používat přes IP adresu serveru, přesměruj port z Windows do WSL. Nejdřív v PowerShellu zjisti interní IP adresu Ubuntu:
wsl -d Ubuntu-24.04 hostname -I
Potom nastav přesměrování a pravidlo firewallu. Nahraď [WSL-IP] první zobrazenou adresou:
netsh interface portproxy add v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP]
New-NetFirewallRule -DisplayName "Supabase" -Direction Inbound -Protocol TCP -LocalPort 8000 -Action Allow
Supabase Studio teď otevřeš na adrese http://[deine-ip]:8000.
Interní IP adresa WSL se může po restartu změnit. Znovu ji zkontroluj a uprav přesměrování pomocí netsh interface portproxy set v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP].
WSL ukončí Ubuntu, jakmile k němu nemá přístup žádné okno ani příkaz. Aby Supabase běželo dál, vytvoř ve Windows soubor C:\Users\<Benutzername>\.wslconfig s následujícím obsahem:
[general]
instanceIdleTimeout=-1
[wsl2]
vmIdleTimeout=-1
Potom v PowerShellu spusť wsl --shutdown a znovu spusť Ubuntu. Kontejnery Supabase se spustí automaticky, jakmile v Ubuntu poběží Docker.
Aby se Supabase spustilo i po restartu serveru, vytvoř v Plánovači úloh úlohu, která se spustí při spuštění systému pod tvým účtem správce (možnost Spustit bez ohledu na přihlášení uživatele). Jako akci zadej wsl.exe a jako argumenty -d Ubuntu-24.04 -u root -- systemctl start docker.
Nikdy nespouštěj produkční provoz s výchozími nebo ukázkovými hodnotami. Nahraď všechny zástupné hodnoty silnými a jedinečnými tajnými údaji, zkontroluj, jestli konfigurace splňuje tvoje bezpečnostní požadavky, a restartuj všechny služby, aby se změny projevily.
Než službu zpřístupníš veřejnosti, vygeneruj bezpečné klíče API. Začni 40znakovým tajným klíčem JWT. Můžeš použít přednastavenou hodnotu nebo si vytvořit vlastní. Ulož tajný klíč lokálně na bezpečné místo. Nesdílej ho ani ho necommituj do systému správy verzí. Pomocí tohoto tajného klíče vygeneruj JWT a z něj odvoď klíče API anon a service pomocí formuláře v dokumentaci Supabase: https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys
Formulář spusť dvakrát, aby se vygenerovaly oba klíče. Aktualizuj soubor .env v projektové složce ~/supabase-project a nastav:
ANON_KEY: klíč anonSERVICE_ROLE_KEY: klíč service
Ve stejném souboru .env nastav požadované tajné údaje. Tyto hodnoty jsou pro funkční instalaci povinné:
POSTGRES_PASSWORD: heslo pro rolipostgresJWT_SECRET: používají ho PostgREST a GoTrueSITE_URL: základní URL tvého webuSMTP_*: přihlašovací údaje k tvému poštovnímu serveruPOOLER_TENANT_ID: ID tenanta používané poolerem Supavisor
Před nasazením do produkčního prostředí zabezpeč dashboard novými přihlašovacími údaji. Uprav také soubor .env:
DASHBOARD_USERNAME: uživatelské jméno k dashboarduDASHBOARD_PASSWORD: heslo k dashboardu
V projektové složce můžeš v souboru volumes/api/kong.yml definovat více uživatelů dashboardu:
basicauth_credentials:
- consumer: DASHBOARD
username: user_one
password: password_one
- consumer: DASHBOARD
username: user_two
password: password_two
Pokud chceš používat všechny funkce dashboardu i mimo localhost, nastav v souboru .env hodnotu SUPABASE_PUBLIC_URL na URL nebo IP adresu, přes kterou chceš dashboard otevřít.
Změny konfigurace použiješ restartováním stacku v projektové složce:
docker compose down
docker compose up -d
Gratulujeme! Supabase jsi úspěšně nainstaloval a nakonfiguroval na svém Windows serveru s WSL2. Doporučujeme ti také podívat se na následující zdroje, které ti pomohou s konfigurací serveru:
- Supabase.com – oficiální web
- Supabase.com/docs/guides/self-hosting – dokumentace Supabase
- learn.microsoft.com/windows/wsl – dokumentace Microsoftu k WSL
Máš konkrétní otázky, na které jsi tady nenašel odpověď? Náš tým je ti každý den k dispozici s dalšími informacemi a podporou – stačí se nám ozvat! 🙂