NEW(1)General Commands ManualNEW(1)

new — create and boot a VM

ssh chroot.dev new [-w] [-c cpus] [-d disk] [-i image] [-m memory] [-n name] [-s script]

new creates a VM and boots it. Without -n the name is random.

The options are as follows:

cpus
Number of cpus.
disk
Size of the data disk in GiB, or with a G or T suffix.
image
Image to start from. The default is base.
memory
Memory in MiB, or with an M or G suffix.
name
Name of the VM: lowercase letters, digits and hyphens. It is also the hostname and the HTTPS name.
script
Run script once as on the first boot. ‘\n’ is a line break; /dev/stdin reads the script from standard input.
Wait until ssh on the VM answers, and print how long it took.

Create a VM named web and wait for ssh:

$ ssh chroot.dev new -n web -w

More memory and a data disk:

$ ssh chroot.dev new -n db -m 512M -d 4G

Install packages on the first boot:

$ ssh chroot.dev new -n app -w -s /dev/stdin < setup.sh

cp(1), resize(1), rm(1), copies(7)

chroot.devOctober 7, 2026NEW(1)