Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.leanly.dev/llms.txt

Use this file to discover all available pages before exploring further.

Connect your GCP project by creating a single service account for Leanly — the operator account. Leanly uses it to create narrowly scoped, workload-specific service accounts as you deploy. No broader access is ever requested.

Connect using our agent skill

The fastest way to connect your GCP project. Our agent skill walks you through the setup and configures the required service account automatically.
Our agent skill is on its way — check back soon.

Manual setup

If you prefer to configure the service account yourself, follow the steps below.

Before you begin

  • GCP project access — make sure you are logged in to the Google Cloud project you want to connect.
  • Your Leanly tenant ID — find this in your Leanly dashboard under Settings.

1. Create the operator service account

1

Open service accounts

In the Google Cloud Console, navigate to IAM & Admin, then Service Accounts.
2

Create a service account

Click Create service account and enter a friendly name (e.g. LeanlyOperator), then click Create and continue.
3

Assign the operator role

Search for and select the Service Account Admin role from the dropdown, then click Continue.
This role allows Leanly to create and manage workload-specific service accounts in your project on your behalf.
4

Add Leanly as a service account user

Under Grant users access to this service account, add the following as a Service Account User.
leanly-devopsengineer@leanlyhq.iam.gserviceaccount.com
Then click Done.
Is your project part of a Google Cloud Organization? Organization-wide policies may restrict which external identities can access your service accounts. If your organization enforces the iam.allowedPolicyMemberDomains constraint, you need to add an exception for Leanly’s directory ID: C03w2fsp3. GCP Allowed Policy Member DomainsSee Google’s documentation for details.
5

Copy the service account email

Copy the email address of the service account you just created — you’ll need it in the next step.

2. Connect the service account to Leanly

1

Open integrations

In your Leanly dashboard, go to Integrations, select Google Cloud, and click Connect Account.
2

Acknowledge the setup

Confirm that you have created the operator service account. This will reveal the service account input field.
3

Provide the service account email

Paste the service account email you copied and click Connect Account.

Permissions

The operator service account is granted the minimum permissions needed to manage workload infrastructure on your behalf.
PermissionAccessWhy
Service Account AdminRead and writeCreate and manage workload-specific service accounts