Supabase is an open-source Postgres development platform that provides a full Postgres database plus authentication, instant APIs, realtime, and storage—an open-source alternative to Firebase.
Supabase consists of several Linux containers. These containers cannot run directly on a Windows Server. Instead, they run in a Linux system that you set up with the Windows Subsystem for Linux (WSL2). In this guide, we’ll show you how to install WSL2 with Ubuntu, set up Docker in it, and start Supabase.
An easier option: use a Linux VPS On a Linux VPS (Debian or Ubuntu), you can install Supabase in just a few clicks using One-Click Apps in the VPS web interface, or manually by following our guide Set Up Supabase on a Linux Server. This is the option we recommend: on Windows, WSL2 also runs as its own virtual machine inside your VPS, using memory and CPU resources and requiring more maintenance. One-Click Apps are not available on Windows VPSs.
Before installing Supabase, make sure your hosting environment meets the following requirements. Windows and the WSL2 environment also need their own resources in addition to those used by Supabase.
| Hardware | Minimum | ZAP-Hosting recommendation |
|---|---|---|
| CPU | 2 vCPU cores | 4 vCPU cores |
| RAM | 8 GB | 16 GB |
| Disk space | 60 GB | 80 GB |
Operating system: Windows Server 2022 or Windows Server 2025
Dependencies: WSL2 with Ubuntu 24.04, with Git and Docker (Engine and Compose) installed in Ubuntu
No Docker Desktop or Windows containers Docker Desktop is not supported by Docker on Windows Server. The Docker Engine from our guide Set Up Docker on a Windows Server only runs Windows containers, so it is not suitable for Supabase. Install Docker inside Ubuntu in WSL2 as described below.
Connect to your server as an administrator using Remote Desktop (RDP). Open PowerShell as an administrator and install WSL2 with Ubuntu 24.04:
wsl --install -d Ubuntu-24.04
Then restart the server. After it restarts, open PowerShell again and start Ubuntu once with wsl -d Ubuntu-24.04. On the first launch, create a Linux username and password.
The message Nested virtualization is not supported on this machine may appear on startup. It only affects virtual machines inside WSL and does not affect Supabase.
Use wsl -l -v to check that Ubuntu is running and using version 2.
Run all the following commands in the Ubuntu console (wsl -d Ubuntu-24.04). First, update the packages and install Git:
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl
Install the Docker Engine and Docker Compose using Docker’s official installation script:
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
Exit the Ubuntu console with exit, run wsl --shutdown in PowerShell, and then reopen Ubuntu so the group membership takes effect. Check the installation with docker version and docker compose version.
For a detailed guide to using Docker on Linux, see our Docker guide.
Once all the requirements are met, you can install Supabase. In the Ubuntu console, clone the Supabase repository, create a project directory, and copy the Docker files and example environment file into it:
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
Switch to the project directory, pull the latest container images, and start the stack in the background:
cd supabase-project
docker compose pull
docker compose up -d
You can now access Supabase Studio in a browser on the server itself at http://localhost:8000. You’ll be prompted for a username and password. The default credentials are:
- Username:
supabase - Password:
this_password_is_insecure_and_should_be_updated
Default credentials Your app is now running with the default credentials. Change them as described in the Configuration section before making Supabase accessible externally.
WSL2 has its own internal network. To access Supabase Studio and the API using your server’s IP address, forward the port from Windows to WSL. First, find Ubuntu’s internal IP address in PowerShell:
wsl -d Ubuntu-24.04 hostname -I
Then configure port forwarding and a firewall rule. Replace [WSL-IP] with the first address shown:
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
You can now access Supabase Studio at http://[your-ip]:8000.
WSL’s internal IP address may change after a restart. Check it again and update the forwarding rule with netsh interface portproxy set v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP].
WSL shuts down Ubuntu as soon as no window or command is accessing it. To keep Supabase running, create the file C:\Users\<Benutzername>\.wslconfig in Windows with the following contents:
[general]
instanceIdleTimeout=-1
[wsl2]
vmIdleTimeout=-1
Then run wsl --shutdown in PowerShell and restart Ubuntu. The Supabase containers will start automatically as soon as Docker is running in Ubuntu.
To make sure Supabase starts again after a server restart, create a task in Task Scheduler that runs at system startup under your administrator account (select Run whether user is logged on or not). Set wsl.exe as the action, with the arguments -d Ubuntu-24.04 -u root -- systemctl start docker.
Congratulations! You’ve successfully installed and configured Supabase on your Windows Server using WSL2. We also recommend checking out these resources to help with your server configuration:
- Supabase.com – Official website
- Supabase.com/docs/guides/self-hosting – Supabase documentation
- learn.microsoft.com/windows/wsl – Microsoft documentation on WSL
Have specific questions that aren’t answered here? Our team is available every day to answer your questions and provide support—just get in touch! 🙂