lightly customise base VM configuration
vms: add a little documentation