← CLI Reference

new

Create a new VM

Options

  • --comment: short note about the VM (max 200 bytes)
  • --cpu: number of CPUs (default 2; run 'billing plan' for plan limits)
  • --disk: disk size (e.g., 20, 20GB, 50G)
  • --env: environment variable in KEY=VALUE format (can be specified multiple times)
  • --image: container image
  • --integration: integration name to attach (can be specified multiple times or comma-separated)
  • --json: output in JSON format
  • --memory: memory allocation (e.g., 4, 4GB, 8G)
  • --name: VM name (auto-generated if not specified)
  • --no-email: do not send email notification
  • --no-pool: use ordinary placement (not available on plans that place new VMs in pools)
  • --pool: create the VM in one of your team's pools (see 'pool list')
  • --prompt: initial prompt to send to Shelley after VM creation (requires an image with Shelley, like exeuntu); use /dev/stdin to read from stdin
  • --registry-auth: private container registry credentials as USERNAME:PASSWORD (e.g. octocat:ghp_xxx) for the registry hosting --image
  • --sandbox: alias for --standalone
  • --setup-script: setup script to run on first boot (max 10KiB); supports \n for newlines; use /dev/stdin to pipe from stdin
  • --standalone: create a standalone VM with its own reserved capacity (requires a plan with standalone VMs and team approval)
  • --tag: tag to add to the VM (can be specified multiple times or comma-separated)

Examples

new                                     # just give me a computer
new --name=b --image=ubuntu:22.04       # custom image and name
new --cpu=4 --memory=16GB               # 4 CPUs, 16GB RAM
new --disk=50GB                         # 50GB disk
new --tag=prod,staging                  # create with tags
new --env FOO=bar --env BAZ=qux         # with environment variables
new --integration=myproxy               # attach an integration
echo 'build me a web app' | ssh exe.dev new --prompt=/dev/stdin