Gradient Docs
Gradient HomeHelp DeskCommunitySign up free
Gradient Next
Gradient Next
  • About Gradient
  • Get Started
    • Quick Start
      • Install the Gradient CLI
    • Core Concepts
    • Organizing Projects
      • Secrets
      • Storing an API key as a Secret
    • Tutorials
      • Gradient Notebooks Tutorial
      • Gradient Workflows Tutorial
      • Gradient Deployments Tutorial
    • FAQ
    • Common Errors
  • Gradient Platform
    • Gradient Notebooks
      • Runtimes
      • Files and storage
      • Machines
      • Terminal
      • Shortcuts
      • Sharing
      • TensorBoard
      • Run on Gradient
    • Gradient Workflows
      • Basic operations
      • Understanding Inputs & Outputs
      • Workflow Spec
      • Gradient Actions
      • Environment Variables
      • Using YAML for Data Science
    • Gradient Deployments
      • Basic operations
      • Deployment Spec
  • Artifacts
    • Container Management
      • Custom Containers
    • Data
      • Versioned Data
        • Public Datasets Repository
        • Storage Providers
      • Persistent Storage
    • Models
      • Managing Models
        • Model Types & Metadata
        • Public Models
    • Code
    • Metrics
      • Push Metrics
      • View & Query Metrics
  • Gradient Cluster
    • Overview
      • Setup
        • Managed Private Clusters
        • Self-Hosted Clusters
          • Pre-installation steps
          • Gradient Installer CLI
          • Terraform
            • Pre-installation steps
            • Install on AWS
            • Install on bare metal / VMs
            • Install on NVIDIA DGX
          • Let's Encrypt DNS Providers
          • Updating your cluster
      • Usage
  • More
    • SDK
      • Projects Client
      • Models Client
      • Deployments Client
      • Workflows Client
      • SDK Examples
      • Full SDK Reference
    • Machine Types
      • Machine Tiers
      • Free Machines (Free Tier)
    • Your Account
      • Teams
        • Creating a Team
        • Upgrading to a Team Plan
      • Hotkeys
      • Billing & Subscriptions
        • Storage Billing
      • Public Profiles
    • Release notes
    • Roadmap
Powered by GitBook
On this page
  1. Artifacts

Container Management

PreviousDeployment SpecNextCustom Containers

Last updated 3 years ago

Whether you are using Notebooks, Workflows or Deployments, Gradient uses containers to provide a code execution environment that allows you to interact with all resources.

In the case of notebooks, you can either use a preconfigured container or bring your own container. To learn more about that see the .

For Workflows and Deployments, you can either use public containers or private containers to set up your environment. With public containers (for example if you wanted to use a generic Tensorflow environment) then Gradient takes care of everything once you specify that in the image for your workflow. Learn more about workflow specs on the .

You can also use a private container in your Workflows and Deployments. Gradient makes it easy for you to store and manage your private registry credentials which you can learn more about below.

Container Registries

You can store credentials for future use in Gradient Resources through the Containers tab in your team settings. Access your team settings by clicking on your user image in the top right of the console.

Within the Containers tab you can add new container registries as well as edit or delete your existing registries.

Creating a new Container Registry Entry

To create a new container registry, simply click the Add a New Container Registry button to get the entry form that will allow you to enter in the following information:

  • name - This field is used to identify your registry in Paperspace resources and must be unique to your team.

  • url - The url associated with the registry hosting the container. For example, If you host your containers on Docker Hub your url would be https://index.docker.io/v1/. This supports an entire base url so you can use self-hosted options or cloud registries like GoogleContainerRegistry (GCR) that path mount your registry endpoint like gcr.io/my-project.

  • namespace - This is the unique location within your registry outlining the loaction of your repository inclusive of namespace, sub-namespaces and tag.

  • username - This is your username login credential for the registry.

  • password - This is your password login credential for the registry. It is suggested you use an Access Token as your password.

Check this out to learn more about .

docker registries
Notebook containers page
tensorflow/tensorflow:2.7.0-gpu-jupyter
getting started with workflows page
Container Tab
New Container Registry
Registry url and Namespace Example