← Back to docs

new

Aliases: create

Create a new GPU instance

Usage

new [flags]

Options

--command container command: auto, none, or a custom command
--count number of GPUs (default: 1) (default: 0)
--disk disk space in GB (default: 50) (default: 0)
--env environment variable KEY=VALUE (can be repeated) (default: [])
--gpu GPU type (default: 4090)
--image container image
--json output in JSON format (default: false)
--limit credit limit per billing cycle (0 = no limit) (default: 0)
--memory minimum CPU memory in GB (default: no minimum) (default: 0)
--name instance name (auto-generated if not specified)

Examples

  new                                    # just give me a GPU
  new --name myvm --image ubuntu:22.04   # custom image and name
  new --env FOO=bar --env BAZ=qux        # with environment variables
  new --count 2 --gpu H100               # multi-GPU instance
  new --command none                     # disable default container command
  new --disk 100 --memory 32             # 100GB disk, min 32GB RAM
  new --limit 50                         # set 50 credits/cycle limit

Accessing Your Instance

After creation, connect to your instance via: