Create a .env file to store your own custom env vars. See example.env

  1. Start the local postgres database in a postgres container: docker-compose -f docker-compose-dev.yml up postgres
  2. Build the auth binary: make build . You should see an output like this:
go build -ldflags "-X github.com/supabase/auth/cmd.Version=`git rev-parse HEAD`"
GOOS=linux GOARCH=arm64 go build -ldflags "-X github.com/supabase/auth/cmd.Version=`git rev-parse HEAD`" -o gotrue-arm64
  1. Execute the auth binary: ./gotrue

If you have docker installed

Create a .env.docker file to store your own custom env vars. See example.docker.env

  1. make build
  2. make dev
  3. docker ps should show 2 docker containers (auth_postgresql and gotrue_gotrue)
  4. That’s it! Visit the health checkendpoint to confirm that auth is running.