Authentication methods

Unique code

Plane lets your users log in with codes sent over email. This is disabled if SMTP is not configured for your instance. See Communication to set up SMTP if you wish to enable unique codes.

Passwords

Your users can log in with passwords that they or you set for them. This is toggled on when SMTP isn’t configured for your instance. Disable it if you would like to use another authentication method below.

Google OAuth

Plane already ships with out-of-the-box support for Google OAuth. This is the easiest option to configure for Google Workspace users.

Configure Plane as an app on Google API Console

First, you will need to identify Plane as an approved OAuth app to Google.

  1. Go to the Google API console and create a new project.
  2. Navigate to the OAuth consent screen under APIs & Services. Choose how you want to configure and register the Plane app, including your target users, and click Create.
  3. Configure the OAuth consent screen with information about the app.
  4. Navigate to the Credentials screen, click Create Credentials, and select OAuth client ID from the options given.
  5. Select Web application under the Application type dropdown list. Update the following fields.
    1. Authorized JavaScript origins
      The HTTP origins that host your web application, e.g., https://app.plane.so
    2. Authorized redirect URIs
      Append the path that users should be redirected to after they have authenticated with Google, e.g., https://app.plane.so/auth/google/callback
    3. Click Create.
    4. Get the Client ID and Client secret under OAuth 2.0 Client IDs on the Credentials screen.

Configure Plane

  1. Go to Google on the Authentication screen of /god mode.
  2. Add the client ID + the client secret from Google API Console.
  3. Click Save .

Your Plane instance should now work with Sign in with Google.

We don’t restrict domains in with Google OAuth yet. It’s on our roadmap.

Github OAuth

Plane also supports GitHub OAuth so your users can sign-in with GitHub instead.

Configure Plane as an OAuth app on GitHub

  1. Log in to your GitHub account.
  2. Click your profile’s avatar and navigate to Settings.
  3. Click Developer Settings and then OAuth Apps.
  4. Click Register a new application.
  5. Configure the following OAuth credentials for your Plane app.
    1. Homepage URL
      The domain, with HTTPS, on which you host Plane, e.g., https://app.plane.so
    2. Authorization Callback URL
      Append /auth/github/callback/ to the Homepage URL, e.g., https://app.plane.so//auth/github/callback/
  6. Click Register application to save it.
  7. Find the app you just registered and click through to find the client ID and the client secret. You will need this for the next steps.

Configure Plane

  1. Go to GitHub on the Authentication screen of /god mode.
  2. Add the client ID + the client secret from the GitHub app you just registered.
  3. Click Save .

Your Plane instance should now work with GitHub sign-in.