Google

In this guide docs.mycompany.com will be used to represent the location you are hosting Outline, it should be replaced with the correct value.

Using Google as an OAuth provider is only supported if you are using Google Workspace

Create a project

API's & Services

OAuth consent screen

  • Go to OAuth consent screen

  • Select Internal for the user type and click “Create” – If you are not a Google Workspace user you will not be able to select this option. It is advisable to use a different method of auth.

  • Choose an “App name”

  • Make sure that “Authorized domains” includes the domain you are using for Outline

Credentials

  • Go to Credentials

  • Click on “Create credentials” and select “OAuth client ID”

  • Choose Web application as the application type

  • Under “Authorized JavaScript origins” enter your domain name again

  • Under “Authorized redirect URIs” enter the URL (replacing the domain name): http://docs.mycompany.com/auth/google.callback

  • Click “Save”

  • Make a note of the Client ID and Secret values

Outline

Add the values noted from the above process in the following environment variables, once you restart the instance you’ll see a new option to sign-in with Google.

GOOGLE_CLIENT_ID=

GOOGLE_CLIENT_SECRET=