Skip to content

Set Up Supabase on Windows

Set up Supabase on a Windows Server: install WSL2 with Ubuntu, configure Docker, start Supabase, and make it accessible externally → Learn more now

12 November 20265 min read27 Views0 helpful

Introduction

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.

Tip

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.

Requirements

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.

HardwareMinimumZAP-Hosting recommendation
CPU2 vCPU cores4 vCPU cores
RAM8 GB16 GB
Disk space60 GB80 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

Warning

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.

Preparation

Install WSL2 and Ubuntu

Connect to your server as an administrator using Remote Desktop (RDP). Open PowerShell as an administrator and install WSL2 with Ubuntu 24.04:

Code
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.

Info

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.

Update the system

Run all the following commands in the Ubuntu console (wsl -d Ubuntu-24.04). First, update the packages and install Git:

Code
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl

Install Docker

Install the Docker Engine and Docker Compose using Docker’s official installation script:

Code
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.

Installation

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:

Code
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:

Code
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
Warning

Default credentials Your app is now running with the default credentials. Change them as described in the Configuration section before making Supabase accessible externally.

Make 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:

Code
wsl -d Ubuntu-24.04 hostname -I

Then configure port forwarding and a firewall rule. Replace [WSL-IP] with the first address shown:

Code
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.

Info

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].

Keep Supabase running continuously

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:

Code
[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.

Conclusion and further resources

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:

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! 🙂

FAQ

Frequently asked questions

Supabase runs in Linux containers. On Windows Server 2022 or 2025, first install WSL2 with Ubuntu, set up Docker Engine and Docker Compose in Ubuntu, then start Supabase with docker compose. One-Click Apps are only available on Linux VPSs.
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.
Because Windows and the WSL2 environment need additional resources, plan for at least 2 vCPU cores, 8 GB of RAM, and 60 GB of disk space. ZAP-Hosting recommends 4 vCPU cores, 16 GB of RAM, and 80 GB of disk space.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.