Supabase Component for Diploi

Run Supabase on Diploi.

Based on the official supabase/docker docker-compose.yml file.

Operation

A full Supabase self-hosted implementation.

Limitations

We know of a few limitations that currently exist with Supabase on Diploi. We are actively working on fixes.

• Connection URI’s displayed on Supabase Studio are wrong, please use the ones on Diploi Console

Authentication

Self-hosted Supabase comes with a simple basic auth implementation by default. Diploi implements custom authentication for the admin panel, making it easier to use. You can authenticate with a single-click from Diploi Console, or use username & password to login.

You can find the admin credentials from a deployments “Options” tab in the Diploi Console.

Development

Functions

You can develop custom functions with Deno. Diploi automatically creates a /functions directory for you with a preconfigured main function and an example hello function.

Migrations

Database migrations and seeding are supported.

Diploi automatically creates a /migrations directory and a seed.sql file for you. They work with the Supabase CLI to manage schema changes and database seeding in a repeatable way.

If the component folder is not named supabase, Diploi creates a supabase symlink inside it so the Supabase CLI works as expected.

For guidance and best practices, see the official Supabase docs on database migrations.

[!IMPORTANT]
Migrations are run automatically in staging and production deployments. In development, use the Supabase CLI to create and run migrations.

[!IMPORTANT]
If your Supabase component is located in a folder named supabase, you can run CLI commands directly from the /app directory. Otherwise, navigate to the component’s folder before running any CLI commands.

Links

• Adding Supabase to a project
• Supabase documentation
• Self-Hosting Supabase with Docker
• Generate Supabase API keys
• Migrations with Supabase CLI