Registry

Besides the public registries like Docker Hub, you can also bind your private registries to your workspace. This allows you to store and deploy your custom images in a private space.

Create New Registry Auth

Navigate to the registries tab in the settings page of your workspace, and then simply click the New registry auth button on the top right corner. You will be choose a registry source from the list.

Currently, we support the following private registrie presets:

• Docker Hub
• Google Container Registry (GCR)
• Azure Container Registry (ACR)
• GitHub Container Registry (GHCR)
• NVIDIA Container Registry (NCR)

You can also create a custom registry auth by providing the registry URL, username, and password.

Use a Private Registry

After you've created a registry auth successfully, you can use it to access your private images for workloads creation.

Take Dev Pod and a docker hub registry as an example, navigate to the pod creation page, and in the Container configuration section, select custom image. Input the image address in the Image field, and select the registry auth you created in the Private image registry auth field.

With these configurations, you can launch your Dev Pod with a private image.

Docker Hub

In this section, we will guide you through the process of setting up a Docker Hub registry for your workspace.

Create Access Token

Navigate to the personal access tokens page, click on Generate New Token. In the creation form, you need to fill in the following fields:

• Token description: A short description for the new access token.
• Expiration date: Defaul is None, which means the token will never expire.
• Access permissions: Select Read-only.

Click on Generate Token, and you will see the new access token created successfully. Copy and save the token securely, you will not be able to access it after closing the page.

You can learn more in the official documentation.

Create Registry Auth

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

You need to fill in the following fields:

• Username: Your Docker Hub username.
• Access Token: The personal access token you just created.

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

GCP

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

Get Service Account Key JSON File

Before creating the registry auth on DGX Cloud 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.

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.

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

Create New Registry Auth on DGX Cloud Lepton

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

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

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 DGX Cloud 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.

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

Azure

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

Obtain Registry Credentials

Navigate to your Azure portal and locate your Azure Container Registry page. If there are no registry in your Azure account yet, you need to create one first.

Open the Access keys tab under Settings, toggle the Admin user switch to on. Copy the password and save it securely.

You can learn more about Azure access token in the official documentation

Create Azure Registry Auth

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

You need to fill in the following fields:

• Registry: The login server URL of your Azure Container Registry, e.g., myregistry.azurecr.io.
• Username: Your Registry username shown in the Azure portal.
• Password: Your Registry password just copied.

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

GitHub

In this section, we will guide you through the process of setting up a GitHub registry for your workspace with access token.

Create Access Token

First, you need to create an access token with the appropriate scopes. Navigate to your GitHub tokens page, click on the Generate new token button.

As you can see, there are several fields to fill out:

• Note: A note for you to identify the token usage.
• Expiration: Recommended to set as No expiration.
• Scopes: In this case, we only need the read:packages scope.

Click on the Generate token button to create the access token.

You can read more in the official documentation.

Create New Registry Auth

Now you've got the personal access token on GitHub, you can then create a new registry auth.

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

You need to fill in the following fields:

• GitHub Username: Your GitHub username.
• Access Token: The personal access token you just created.

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

NVIDIA

In this section, we will guide you through the process of setting up a Nvidia registry for your workspace.

Create API Key

Before creating the registry auth on DGX Cloud Lepton, you need to create an API key for your Nvidia account. Navigate to the API Keys page, click on Generate Personal Key.

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

• Key Name: The name for the new API key.
• Expiration: The expiration date for the new API key.
• Services Included: The services included in the new API key, select Private Registry here.

Click on Generate Personal Key, and you will see the API key created successfully. Copy and save the API key securely, you will not be able to access it after closing the page.

You can learn more details in the official documentation.

Create Registry Auth

Navigate to the registry settings page, click on New registry auth, and select Nvidia as the source. You need to fill in the following fields:

• API Key: The API key you just copied.

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

Custom

Besides the presets, you can also configure a custom registry for your workspace.

Create Custom Registry Auth

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

You need to fill in the following fields:

• Name: A name for your registry.
• Registry: The URL of your registry.
• Username: Your Registry username.
• Password: Your Registry password.