Skip to main content

​
Docker Commands

Run Docker containers on Lyceum Cloud with support for custom images, environment variables, and private registries.

​
Commands

CommandDescription
lyceum docker runExecute a Docker container on Lyceum Cloud
lyceum docker logsStream logs from a Docker execution
lyceum docker registry-examplesShow Docker registry credential format examples

​
lyceum docker run

Execute a Docker container on Lyceum Cloud. 
lyceum docker run <image>

​
Arguments

ArgumentDescription
image(required) Docker image to run

​
Options

OptionDescription
--machine, -mMachine type. Default: cpu
--timeout, -tExecution timeout in seconds. Default: 300
--file-name, -fName for the execution
--command, -cCommand to run in container
--env, -eEnvironment variables (repeatable, format: KEY=value)
--detach, -dRun in background and print execution ID
--callbackWebhook URL for completion notification
--registry-credsDocker registry credentials as JSON string
--registry-typeRegistry credential type (basic, aws, etc.)

​
Examples

# Run a basic container
lyceum docker run python:3.11

# Run with a command
lyceum docker run python:3.11 --command "python -c 'print(1+1)'"

# Run on GPU
lyceum docker run nvidia/cuda:12.0-base --machine a100

# Set environment variables
lyceum docker run myimage --env API_KEY=secret --env DEBUG=true

# Run in background
lyceum docker run long-running-job --detach

# Set custom timeout (10 minutes)
lyceum docker run myimage --timeout 600

# With webhook callback
lyceum docker run myimage --callback https://myapp.com/webhook

​
Private Registry Authentication

# Basic auth
lyceum docker run private.registry.com/myimage \
  --registry-type basic \
  --registry-creds '{"username": "user", "password": "pass"}'

# AWS ECR
lyceum docker run 123456789.dkr.ecr.us-east-1.amazonaws.com/myimage \
  --registry-type aws \
  --registry-creds '{"access_key_id": "...", "secret_access_key": "...", "region": "us-east-1"}'

​
lyceum docker logs

Stream logs from a running or completed Docker execution. 
lyceum docker logs <execution_id>

​
Arguments

ArgumentDescription
execution_id(required) Execution ID to stream logs from

​
Examples

# Stream logs from an execution
lyceum docker logs exec_abc123

​
lyceum docker registry-examples

Display example credential formats for various Docker registries. 
lyceum docker registry-examples
This shows JSON formats for:
  • Basic authentication
  • AWS ECR
  • Google Container Registry
  • Azure Container Registry