Skip to main content

Use DBOS With Supabase

This guide shows you how to deploy a DBOS application with Supabase. Your application is hosted in DBOS Cloud, but stores its data in Supabase.

1. Connect to Supabase​

Visit https://console.dbos.dev/provision and click "Connect Supabase" to connect your DBOS and Supabase accounts.

Cloud Console Templates

After connecting your Supabase account, you should see a list of your Supabase projects. Choose one to use with DBOS. When prompted, enter your Supabase database password (you set this when you created your Supabase project, if you forgot it you can reset it from your Supabase dashboard).

Cloud Console Templates

Congratulations! You've linked your Supabase project to DBOS. Now, let's deploy a DBOS app to your Supabase database.

2. Select a Template​

Visit https://console.dbos.dev/launch. At the top of the page, make sure your Supabase database instance is selected.

Cloud Console Templates

Then, choose a template you'd like to deploy.

Not sure which template to use? We recommend the DBOS + FastAPI starter.

Cloud Console Templates

3. Connect to GitHub​

To ensure you can easily update your project after deploying it, DBOS will create a GitHub repository for it. You can deploy directly from that GitHub repository to DBOS Cloud.

First, sign in to your GitHub account. Then, set your repository name and whether it should be public or private.

Deploy with GitHub

4. Deploy to DBOS Cloud​

Click "Create GitHub Repo and Deploy" and DBOS will clone a copy of the source code into your GitHub account, then deploy your project to DBOS Cloud. In less than a minute, your app should deploy successfully.

Congratulations, you've successfully deployed an app to DBOS Cloud and Supabase!

Deploy Success

5. View Your Application​

At this point, your app is deployed, with its very own URL assigned. If you continue to your application page, you can click on the URL to see your application live on the Internet.

Application page

To start building, edit your application on GitHub (for the DBOS + FastAPI starter, source code is in app/main.py), commit your changes, then press "Deploy From GitHub" to see your changes reflected in the live application.

Next Steps​

To learn more about building reliable applications with DBOS, check out the programming guide (Python, TypeScript).