Skip to main content

Google OAuth Setup

This step connects Playrunner to a Google account. It does not create Google Cloud infrastructure and it does not run Terraform.

1. Open the Connect Dialog​

Start Playrunner locally from the repo root (if not already running):

./start-local.sh

Open Integrations, choose Connect to GCP, and copy the Authorized redirect URI shown in the dialog.

With the default local app URL, the redirect URI is:

http://127.0.0.1:3100/oauth/callback/gcp

Use the value shown in your dialog if your local frontend is running on a different host or port.

2. Create the Google OAuth Client​

  1. Open Google Cloud Console APIs & Services.
  2. Open OAuth consent screen.
  3. Create or update the consent screen for the project.
  4. Add the Google account that will authenticate with Playrunner as a test user if the app is still in testing.
  5. Open Credentials.
  6. Click Create Credentials and choose OAuth client ID.
  7. Set Application type to Web application.
  8. Add the redirect URI from Playrunner as an Authorized redirect URI.
  9. Create the client.
  10. Copy the generated Client ID and Client Secret.

3. Authenticate in Playrunner​

  1. Paste the Client ID and Client Secret into the Connect to GCP dialog.
  2. Click Authenticate.
  3. Complete the Google OAuth popup.
  4. After the dialog shows Connected to GCP, select or enter the Google Cloud project ID.
  5. Set the Cloud Run region, for example us-central1.
  6. Click Save GCP Settings.

Playrunner stores the OAuth tokens, selected project, Cloud Run region, and standard runner defaults in the local CloudCredential row.

The project list is only an autocomplete convenience. On a new Google Cloud project, the lookup can be unavailable until Cloud Resource Manager is enabled. Enter the project ID manually and continue to Terraform; Terraform enables the required APIs for the selected project.

4. Continue to Terraform​

After saving the GCP settings, continue to Terraform setup.