OAuth / OIDC

You can authenticate users with an OAuth2 provider, like GitHub or Google, or a custom OpenID Connect provider, like Authelia or Zitadel.

Redirect URL

When creating your OAuth2 app, use <your-beszel-url>/api/oauth2-redirect as the callback/redirect URL.

Setup

1. Toggle off the "Hide collection create and edit controls" switch on /_/#/settings.

2. Edit the users collection.

3. In the "Options" tab, enable OAuth2 and add your provider.

4. Toggle the switch back on in /_/#/settings.

Automatic user creation

Beszel does not allow automatic user creation by default. To enable it, set USER_CREATION=true in the hub environment variables.

Supported providers

• Apple
• Bitbucket
• Discord
• Facebook
• Gitea
• Gitee
• GitHub
• GitLab
• Google
• Instagram
• Kakao
• Linear
• LiveChat
• mailcow
• Microsoft
• monday.com
• Notion
• OpenID Connect
• Patreon (v2)
• Spotify
• Strava
• Twitch
• Twitter
• VK
• WakaTime
• Yandex