Supabase

Overview

The Supabase Manager page helps you run a self-hosted Supabase instance on your server: monitor the service status, access Supabase Studio, view the API Gateway URL, and link Supabase to a custom domain with SSL.

INFO

This feature is only available on paid plans. On the free plan, the page shows an Upgrade Now button.

Installation

Before installation, the Supabase item is listed under the Explore group of the server menu. After installation, Supabase appears directly in the server menu.

1. Go to the Applications page of your server.
2. Select the Not Installed filter.
3. Locate Supabase in the list.
4. Click the Install icon (download arrow) at the end of the row.
5. Enter a Password for Supabase Studio and a Port (default: 8000).
6. Click Install to begin. Docker will be installed automatically if it is not already present.

TIP

You can also click Install directly on the Supabase page when the app is not installed yet. In that case, the Studio password is generated randomly and the default port 8000 is used. To choose your own password, install it from the Applications page as described above.

Usage Guide

Status

The Status card displays key information about your Supabase instance:

• Version: The currently installed version of Supabase.
• Port: The port on which Supabase is running.

Accessing the Dashboard

Supabase Studio Dashboard

The Access Links card provides the URL to access Supabase Studio. Use the buttons to:

• Copy link (copy icon): Copy the Studio URL to your clipboard.
• Open Studio (open-in-new-tab icon): Open Studio in a new browser tab.

Basic Auth Credentials

When accessing Supabase Studio, the browser will prompt you to log in:

• Username: supabase
• Password: The password you entered during installation.

You can change the password by editing DASHBOARD_PASSWORD in /opt/supabase/.env and restarting Supabase.

API Gateway

Your applications use the API Gateway URL to connect to Supabase services (REST API, Auth, Storage, Realtime). Click Copy URL to copy it and use it in your application configuration.

Access via Domain

You can link Supabase to a website to access it via a custom domain name with SSL, instead of using the IP address and port directly.

Linking to a Website

1. Click the Link to Website button.
2. Choose one of two options:
   • Select Existing Website: Pick a website already created on this server from the dropdown, then click Link.
   • Create New Website: Fill in the details to create a new website that will act as a reverse proxy to Supabase.
3. Once linked, the Studio Dashboard and API Gateway URLs will automatically update to use the linked domain.

Managing Linked Websites

After linking, the Access via Domain section displays all linked websites with the following actions:

• Manage: Navigate to the website management page.
• Access: Open the website in a new browser tab.
• Unlink: Remove the link between the website and Supabase.

You can link multiple websites to Supabase by clicking Link another Website.

Service Management

Located at the top right of the page:

• Service status: Shows whether Supabase is running or stopped.
• Actions:
  • Use the Start, Restart, or Stop buttons to control the service.
  • Click the Update Supabase to ... button (only shown when a new version is available) to upgrade Supabase.

To uninstall Supabase, go to the Applications page, select the Installed filter, find Supabase, and click the Uninstall icon.

Notes & Warnings

• Warning: Exposing Supabase via a public domain makes it accessible from the internet. Ensure your Basic Auth password is strong.
• Note: Supabase requires Docker to run. Docker will be automatically installed during the Supabase installation process.
• Note: The default port is 8000. Make sure this port is not already in use by another application.