GCP Registry

In this section, we will guide you through the process of setting up a GCP Registry for your Lepton workspace.

Get Service Account Key JSON File

Before creating the registry auth on Lepton, you will need to get the service account key JSON file.

Create Service Account for Registry Auth

Navigate to the service accounts page in GCP console, select the target project, and then click the Create service account button.

In the second step, you need to grant registry auth role to the service account. In this case, you need to grant Artifact Registry Reader role so that the service account can access the Artifact Registry and pull images.

grant access 0.7x

Create Service Account Key

After creating the service account, you need to create a key for it. Navigate to the service account page, switch to the KEYS tab, press on ADD KEY button and select JSON as the key type.

add key 0.7x
key type json 0.7x

Click on CREATE, and the JSON file will be downloaded automatically.

Create New Registry Auth on Lepton

Now you've got the service account key JSON file, you can create a new registry auth for GCP on Lepton.

Navigate to the registry settings page, click on New registry auth, and select GCP as the source.

new registry auth 0.7x

In the creation form, you need to fill in the following fields:

  • Name: The name for the new registry, just for you to manage registries on Lepton easily.
  • Registry: The URL of the GCP Artifact Registry, for example, https://us-west1-docker.pkg.dev.
  • Json Key: The JSON key file for the service account, you can upload the file by clicking on the Upload Service Account Key button.
creation form 0.8x

After filling in the form, click on Submit, and you will see the new registry auth created successfully.

For more details about how to use the registry auth, you can refer to this page.

Lepton AI

© 2025