Skip to main content

OAuth2 Configuration

OAuth2 allows you to authenticate to Remnawave dashboard using one of the configured providers.

OAuth2 Configuration

Remnawave supports the following providers:

Github​

Create an OAuth application​

You will need to create an OAuth application in Github.
Follow this link to create an application: https://github.com/settings/applications/new

Authorization callback URL
# Replace YOUR_PANEL_DOMAIN with your panel domain
https://YOUR_PANEL_DOMAIN/oauth2/callback/github
warning

Don't forget to set the correct callback URL. Change YOUR_PANEL_DOMAIN to your panel domain.

Configuring OAuth2 in Remnawave​

  1. Open Remnawave Panel and move to Remnawave Settings -> Authentication Methods.
  2. Select desired method and click on it to open configuration.
  3. Click on Enable button.
  4. Enter Client ID and Client Secret.
  5. Enter List of allowed emails.
  6. Click on Save button.

PocketID​

Create an OIDC Client​

Login to your self-hosted PocketID instance and go to Settings β†’ OIDC Clients β†’ Add OIDC Client.

Authorization callback URL
# Replace YOUR_PANEL_DOMAIN with your panel domain
https://YOUR_PANEL_DOMAIN/oauth2/callback/pocketid
warning

Don't forget to set the correct callback URL. Change YOUR_PANEL_DOMAIN to your panel domain.

Yandex​

danger

It is not recommended to use Yandex OAuth2 for self-hosted Remnawave instances.

Create an OAuth application​

You will need to create an OAuth application in Yandex.

Follow this link to create an application: https://oauth.yandex.com/client/new

In the second step of creation select "Web application" and set the following callback URL:

Authorization callback URL
# Replace YOUR_PANEL_DOMAIN with your panel domain
https://YOUR_PANEL_DOMAIN/oauth2/callback/yandex
warning

Don't forget to set the correct callback URL. Change YOUR_PANEL_DOMAIN to your panel domain.

In the third step of creation allow "Access to email address", no other permissions are needed.