Code Ocean VPC Administration Guide
v2.11
v2.11
  • Code Ocean VPC Administration Guide
  • Overview
    • System Overview
    • System Capacity and Sizing
  • Installation Guide
    • Prerequisites
    • CloudFormation Deployment
    • Deployment Parameters
    • Deployment IAM role
    • Subdomain Delegation
    • Create an Admin Account
    • Upgrade Code Ocean
    • Remove Code Ocean
  • Management Guide
    • User Management
      • Admin Signup
      • Adding/Removing an Administrator
      • Inviting New Users
      • Generating a Reset Password Link
      • Deactivate User
    • Set up a User Banner Message
    • Enable Git Integration
    • Starter Environments
      • Deploy Base Image
      • Image Actions
      • Deploying Private Docker Base Images
    • Set up an Authentication
    • SCIM Provisioning using Azure Active Directory
    • SCIM Provisioning using Okta
    • Configure Worker Parameters
    • ACM Certificate Renewal
  • Troubleshooting Guide
    • Collecting Logs with the Support Bundle
    • Searching Logs in AWS CloudWatch
    • Alarms
Powered by GitBook
On this page
  • Deploy Recommend Base Image
  • Deploy Custom Image
  • Deploying Docker Images Examples
  • Tracking Deployment Status

Was this helpful?

  1. Management Guide
  2. Starter Environments

Deploy Base Image

Learn to deploy Docker images in Code Ocean.

PreviousStarter EnvironmentsNextImage Actions

Last updated 2 years ago

Was this helpful?

You can deploy Docker images as starter environments for compute capsules. are also called base images and will be available for users in their capsule's environment editor. The starter environments may include different machine languages, versions of languages and IDEs, software packages, etc., so users can start customizing their ideal compute environments efficiently.

You can deploy a recommended base image or switch tags to build a custom image.

Click on +Add New Base Image and the ‘New Base Image’ dialog will appear with the ‘Recommended’ view.

Deploy Recommend Base Image

We currently provide three base images to deploy. You can select the images and click on the Deploy button to deploy the recommended base image.

Deploy Custom Image

Complete the fields and click Deploy to deploy the image (see an explanation about each field below).

Fill fields from existing image

The system keeps a list of images deployed in each VPC account. Clicking on it will show all the deployed image names.

Name (required, editable)

The name of the image. Any name that reflects the language or purpose of the image is suitable.

Docker Image (required)

The URL of the image to pull from. Any public Docker image URL or any base image from the Code Ocean Docker registry starting with registry.codeocean.com works. For private image URLs, contact support@codeocean.com

Version (required, editable)

The version of the image so you can keep track of future updates. Different versions of images under the same name will be grouped together in the Environment Editor.

Language (required, editable)

The programming language tag for this image. The language tag can be used for filtering in the Environment manager.

Description (optional)

The description of this base image so end users can understand what the image is about.

Machine Type (optional)

Standard: with CPU only, GPU: with GPU.

Tags (optional)

Keywords relevant to the image such as language, version, etc., so it's easier to search the image.

  • Name + version combination must be unique

  • The docker image source of the new image must be unique

The default user in the container from the new image needs to be the root user for it to access the folder in the cloud workstation and the computation. Keep this in mind if pulling from a public docker image. If you are creating the docker file, please add this line: USER 0:0 ( which means set the user inside the container to root).

Deploying Docker Images Examples

Below are the examples of completed forms from the recommend base image:

This is an example of a Python image that runs on CPU-only instances:

This is an example of an R image that runs on CPU-only instances:

This is an example of a Python image that runs on instances with GPUs:

Tracking Deployment Status

After you click on Deploy, you can track the deployment status in the images list.

The starter environments