new

Create a new VM

Options

• --command: container command: auto, none, or a custom command
• --comment: short note about the VM (max 200 bytes)
• --cpu: number of CPUs (default 2)
• --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
• --prompt: initial prompt to send to Shelley after VM creation (requires exeuntu image); use /dev/stdin to read from stdin
• --setup-script: setup script to run on first boot (max 10KiB); supports \n for newlines; use /dev/stdin to pipe from stdin
• --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