SSO is currently not supported. If you’d like SSO, please reach out using our contact form
If you’re switching from non-auth, delete the Sourcebot cache (the .sourcebot folder) before starting.

Sourcebot has built-in authentication that gates access to your organization. OAuth, email codes, and email / password are supported. To enable authentication, set the SOURCEBOT_AUTH_ENABLED environment variable to true. When authentication is enabled:

  • Connection managment happens through the UI
  • Members must be invited to an organization to gain access
  • If you’re in single-tenant mode, the first user to register will be made the owner of the default organization. Check out the roles page for more info on the different roles and permissions

​
Authentication Providers

Make sure the AUTH_URL environment variable is configured correctly when using Sourcebot in a deployed environment.

To enable an authentication provider in Sourcebot, configure the required environment variables for the provider. Under the hood, Sourcebot uses Auth.js which supports many providers. Submit a feature request on GitHub if you want us to add support for a specific provider.

​
Email / Password

Email / password authentication is enabled by default. It can be disabled by setting AUTH_CREDENTIALS_LOGIN_ENABLED to false.

​
Email codes

Email codes are 6 digit codes sent to a provided email. Email codes are enabled when transactional emails are configured using the following environment variables:

  • SMTP_CONNECTION_URL
  • EMAIL_FROM_ADDRESS

See transactional emails for more details.

​
GitHub

Auth.js GitHub Provider Docs

Required environment variables:

  • AUTH_GITHUB_CLIENT_ID
  • AUTH_GITHUB_CLIENT_SECRET

​
Google

Auth.js Google Provider Docs

Required environment variables:

  • AUTH_GOOGLE_CLIENT_ID
  • AUTH_GOOGLE_CLIENT_SECRET

​
Troubleshooting

  • If you experience issues logging in, logging out, or accessing an organization you should have access to, try clearing your cookies & performing a full page refresh (Cmd/Ctrl + Shift + R on most browsers).
  • Still not working? Reach out to us on our discord or github discussions