Set Up Supabase on a Linux Server – Launch Your Open-Source Backend Platform

Learn how to host and configure Supabase for a reliable open-source Postgres platform with authentication and realtime features → Find out more

10 November 20264 min read0 Views0 helpful

Introduction

Supabase is an open-source Postgres development platform that provides a complete Postgres database along with authentication, instant APIs, realtime features, and storage—a great open-source alternative to Firebase.

Want to host this service yourself? We’ll show you step by step how to set up and configure Supabase, including everything you need to know.

Set Up Supabase on a Linux Server – Launch Your Open-Source Backend Platform

Install Supabase with One-Click Apps

You can install Supabase directly through One-Click Apps in the VPS web interface. After the initial setup, open the app catalog, search for Supabase, and start the installation using your preferred project, environment, and domain settings. This gives you a quick and user-friendly way to deploy and manage Supabase—without manually setting it up from the command line, and with integrated web management and support for custom domains and SSL where available.

Requirements

Before installing Supabase, make sure your hosting environment meets the following requirements to ensure a smooth installation and optimal performance.

Hardware	Minimum	ZAP-Hosting recommendation
CPU	1 vCPU core	4 vCPU cores
RAM	4 GB	8 GB
Disk space	25 GB	25 GB

The software requires all necessary dependencies and a supported operating system. Before installing, check that your server meets the following requirements:

Dependencies: Git, Docker (Engine and Compose)

Operating system: Latest version of Ubuntu/Debian with Docker Engine and Docker Compose v2

Make sure all dependencies are installed and the correct operating system is running to avoid compatibility issues when installing Supabase.

Preparation

Before setting up Supabase, you need to prepare your system. This means updating your operating system and installing all required dependencies. This ensures a stable environment and helps avoid problems during or after installation.

Update your system

To make sure your system has the latest software and security updates, start by updating it. Run the following command:

Code

sudo apt update && sudo apt upgrade -y

This ensures your system has the latest security patches and software versions before installation.

Install dependencies

After updating, you can install the required dependencies.

Git

Supabase data is downloaded from GitHub, so Git must be installed. Run the following command:

Code

sudo apt install git-all

Docker

Supabase runs in a Docker container on your server, so Docker must be installed. Run these commands:

Code

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

For detailed instructions on installing and using Docker, see our Docker guide.

Installation

Now that all requirements are met and preparations are complete, you can start installing Supabase.

Get the Supabase repository, create a project directory, and copy the Docker files and example environment file into it.

Code

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

Go to the project directory, download 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 at http://<deine-ip>: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. Secure your services as soon as possible by following the instructions below.

Configuration

Never go live with default or example values. Replace all placeholders with strong, unique secrets, review the configuration to meet your security requirements, and restart all services for the changes to take effect.

Generate secure API keys before making a service publicly accessible. Start with a 40-character JWT secret. You can use the provided value or create your own. Store the secret locally in a secure place. Don’t share it or commit it to version control. Use the secret to generate a JWT and derive the anon and service API keys using the form in the Supabase docs: https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys

Submit the form twice to generate both keys. Update your ./docker/.env with:

ANON_KEY: anon key
SERVICE_ROLE_KEY: service key

Set the required secrets in ./docker/.env. These values must be set for the installation to work:

POSTGRES_PASSWORD: password for the postgres role
JWT_SECRET: used by PostgREST and GoTrue
SITE_URL: base URL of your site
SMTP_*: mail server credentials
POOLER_TENANT_ID: tenant ID used by the Supavisor pooler

Protect the dashboard with new credentials before using it in production. Edit ./docker/.env:

DASHBOARD_USERNAME: dashboard username
DASHBOARD_PASSWORD: dashboard password

You can define multiple dashboard users in ./docker/volumes/api/kong.yml:

Code

basicauth_credentials:
  - consumer: DASHBOARD
    username: user_one
    password: password_one
  - consumer: DASHBOARD
    username: user_two
    password: password_two

To enable all dashboard features outside localhost, set SUPABASE_PUBLIC_URL in ./docker/.env to the URL or IP address you use to access the dashboard.

Apply the configuration changes by restarting the stack:

Code

docker compose down
docker compose up -d

Conclusion and additional resources

Congratulations! You’ve successfully installed and configured Supabase on your VPS/Dedicated Server. We recommend checking out these resources for more help with configuring your server:

Supabase.com – Official website
Supabase.com/docs/guides/self-hosting – Supabase documentation

Still have questions that weren’t answered here? Our support team is available every day to help—just get in touch! 🙂

FAQ

Frequently asked questions

You can install Supabase directly through One-Click Apps in the VPS web interface. Search for Supabase in the app catalog and start the installation with your preferred project, environment, and domain settings.

Supabase requires Git and Docker (Engine and Compose), and runs on the latest version of Ubuntu/Debian with Docker Compose v2.

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.

Which 🍪 cookies would you like to allow?

Set Up Supabase on a Linux Server – Launch Your Open-Source Backend Platform

Introduction

Install Supabase with One-Click Apps

Requirements

Preparation

Update your system

Install dependencies

Git

Docker

Installation

Configuration

Conclusion and additional resources

Frequently asked questions

Software

Install Supabase with One-Click Apps

Preparation

Update your system

Install dependencies

Git

Docker

Installation

Configuration

Conclusion and additional resources

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting