The Supabase addon integrates your Latitude.sh database with Supabase, providing auto-generated APIs and direct database management tools such as a table editor and SQL editor, all running on top of your existing PostgreSQL database.

​
Enabling the Supabase Addon

The Supabase addon can only be enabled for an existing database. It cannot be configured during the initial database creation process. To enable the Supabase addon:
  1. Navigate to the Databases section in your Latitude.sh dashboard.
  2. Select the database for which you want to enable the Supabase addon. This will take you to the database overview page.
  3. Locate and click the Enable Supabase Addon button on this page.

​
After Enabling

Once the Supabase addon is successfully enabled, you will be provided with two important API keys:
  • API_ANON_KEY: This is the anonymous public key. It’s intended for client-side usage, for example, when using the Supabase client library in your frontend application. This key has limited permissions as defined by your Row Level Security (RLS) policies.
  • API_SERVICE_ROLE_KEY: This is the service role key. It’s intended for server-side usage, such as in your backend services or scripts. This key has full access to your database and can bypass Row Level Security (RLS) policies. Treat this key like a password and keep it secure.
After enabling the addon, the “Enable Supabase Addon” button will change to an Open dashboard link. Clicking this link will take you directly to your Supabase project dashboard associated with this database.

​
Accessing the Supabase Dashboard

There are two primary ways to access your Supabase dashboard once the addon is enabled:
  1. Open Dashboard Link: As mentioned above, after enabling the addon, the button on the database overview page transforms into an “Open dashboard” link.
  2. Supabase Button: On the database overview page, in the top right corner next to the “Actions” button, you will find a dedicated Supabase button. Clicking this button will also navigate you to the Supabase project dashboard.
This provides convenient access to the Supabase dashboard where you can use features such as the table editor and SQL editor, and manage your Supabase API access.

​
Troubleshooting

If you encounter issues with the Supabase addon:
  1. Verify API Key Usage: Ensure you are using the correct Supabase API keys (API_ANON_KEY for client-side, API_SERVICE_ROLE_KEY for server-side) and that they are correctly implemented in your application.
  2. Check Network Connectivity: Confirm that your application can reach the Supabase endpoint associated with your database.
  3. Review Database Logs: Check your database logs for any error messages that might indicate issues with the Supabase integration or underlying database operations.
  4. Consult Supabase Documentation: For issues related to Supabase-specific features or client libraries, the official Supabase documentation can be a valuable resource.
If you continue to experience issues with the Supabase addon, contact Latitude.sh support for assistance.