Skip to content

CLI reference

jrun is a modern CLI with an interactive shell, command autocomplete, and a minimal, well-thought set of commands. Everything you need, nothing you don't.

Command Description
jrun Interactive shell
jrun start Boot the VM (downloads FreeBSD on first run)
jrun start --base <config> Boot the VM with a base config applied
jrun start --provision Re-run base provisioning on an already-booted VM
jrun start --mode graphic Boot the VM with a graphical QEMU display
jrun stop Shut down the VM gracefully
jrun ssh SSH into the VM
jrun ssh <n> SSH directly into a jail
jrun cmd Run a command inside a jail
jrun up Create or update all jails in a config
jrun up <config> <name...> Deploy specific jails (dependencies included automatically)
jrun pause Interactively select existing jails to stop without destroying them
jrun pause <name...> Stop specific existing jails without destroying them
jrun down Interactively select existing jails to destroy
jrun down <name...> Destroy specific jails
jrun status Show VM and jail status
jrun status --tree Show VM and jail status as a tree
jrun purge Stop and destroy the VM with all jails