Auth architecture

The architecture behind Supabase Auth.

There are four major layers to Supabase Auth:

  1. Client layer. This can be one of the Supabase client SDKs, or manually made HTTP requests using the HTTP client of your choice.
  2. Kong API gateway. This is shared between all Supabase products.
  3. Auth service (formerly known as GoTrue).
  4. Postgres database. This is shared between all Supabase products.

Client layer

The client layer runs in your app. This could be running in many places, including:

  • Your frontend browser code
  • Your backend server code
  • Your native application

The client layer provides the functions that you use to sign in and manage users. We recommend using the Supabase client SDKs, which handle:

  • Configuration and authentication of HTTP calls to the Supabase Auth backend
  • Persistence, refresh, and removal of Auth Tokens in your app's storage medium
  • Integration with other Supabase products

But at its core, this layer manages the making of HTTP calls, so you could write your own client layer if you wanted to.

See the Client SDKs for more information:

Auth service

The Auth service is an Auth API server written and maintained by Supabase. It is a fork of the GoTrue project, originally created by Netlify.

When you deploy a new Supabase project, we deploy an instance of this server alongside your database, and inject your database with the required Auth schema.

The Auth service is responsible for:

  • Validating, issuing, and refreshing JWTs
  • Serving as the intermediary between your app and Auth information in the database
  • Communicating with external providers for Social Login and SSO


Supabase Auth uses the auth schema in your Postgres database to store user tables and other information. For security, this schema is not exposed on the auto-generated API.

You can connect Auth information to your own objects using database triggers and foreign keys. Make sure that any views you create for Auth data are adequately protected by enabling RLS or revoking grants.