Cloudflare Workers

Using Supabase in Cloudflare Workers has always been a great way to interact with your data from the edge. Supabase-js communicates with your Supabase Postgres instance via HTTP using PostgREST, so you never need to worry about running out of database connections.

In this guide we'll walk you through a new addition to the Cloudflare Workers dashboard - the ability to authenticate directly with your Supabase account, and automatically inject your Supabase environment variables into your Worker code.

How To Enable Supabase Integration in Cloudflare Workers#

Start by heading to the Cloudflare Dashboard, go to the Workers & Pages tab and hit 'Create Application' followed by 'Create Worker'.

Deploy the Hello World example Worker. Once it's deployed hit 'Configure Worker'.

On the configuration page select the Settings tab, followed by the Integrations option.

You should now see the database integration options. On the Supabase card, click 'Add Integration'

After reviewing and accepting the terms, you will be shown the option to connect and a Supabase popup should appear.

Follow the flow by selecting your Supabase Org and the Project you wish to connect to. If you don't have any projects yet, head over to the Supabase Dashboard to create one.

Once it's connected you will be given the option to select which Supabase Key you want to pull into the Worker context.

The Anon key here is one that always adhires to the Database's RLS policies (read more on Row Level Security).

The Service Role is typically ok to use in backend contexts, such as Cloudflare Workers, but note that this key bypasses your Row Level Security policies, and has the ablity to read, write, and delete any data in your database.

Once this is done the SUPABASE_KEY and SUPABASE_URL environment variables will now be available from your Cloudflare Worker code.

You can now install the supabase-js client in your Worker:

npm install @supabase/supabase-js

Then you can initiate the Supabase client, and start querying your data:

import { createClient } from '@supabase/supabase-js'
export default {
  async fetch(request, env) {
    const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_KEY)
    const { data, error } = await supabase.from('countries').select('*')
    if (error) throw error
    return new Response(JSON.stringify(data), {
      headers: {
        'Content-Type': 'application/json',
      },
    })
  },
}

The snippet above assumes you already have a countries table. Run the following in the SQL Editor in the Supabase Dashboard if you wish to install this demo schema:

create table countries (
  id serial primary key,
  name varchar(255) not null
);
insert into countries
  (name)
values
  ('Oceania');
insert into countries
  (name)
values
  ('Genovia');
insert into countries
  (name)
values
  ('Wakanda');
insert into countries
  (name)
values
  ('Lilliput');

Remember that you don't need to use supabase-js to connect to your Supabase database, you can connect "directly" to the underlying Postgres database using the connection string (every Supabase database comes pre-installed with a connection pooler), or you can try Cloudflare's new TCP socket method of connecting to Postgres directly from Cloudflare Workers.

Edit this page on GitHub