From 3f9f87ec633df4306b9f889cc7469bc820fd32e0 Mon Sep 17 00:00:00 2001 From: Andrew David Wong Date: Sat, 26 Jan 2019 17:14:47 -0600 Subject: [PATCH] Document opening in DipsVM based on non-default DVM Template Closes QubesOS/qubes-issues#4753 --- common-tasks/disposablevm.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/common-tasks/disposablevm.md b/common-tasks/disposablevm.md index 631ca8ff..d92ff57f 100644 --- a/common-tasks/disposablevm.md +++ b/common-tasks/disposablevm.md @@ -143,6 +143,20 @@ The label color will be inherited from the `dvm-template`. (The DisposableVM Application Launcher shortcut used for starting programs runs a very similar command to the one above.) +#### Opening a link in a DisposableVM based on a non-default DVM Template from a qube #### + +Suppose that the default DVM Template for your `email` qube has no networking (e.g., so that untrusted attachments can't phone home). +However, sometimes you want to open email links in DisposableVMs. +Obviously, you can't use the default DVM Template, since it has no networking, so you need to be able to specify a different DVM Template. +You can do that with this command from the `email` qube (as long as your RPC policies allow it): + +~~~ +$ qvm-open-in-vm @dispvm:online-dvm-template https://www.qubes-os.org +~~~ + +This will create a new DisposableVM based on `online-dvm-template`, open the default web browser in that DisposableVM, and navigate to `https://www.qubes-os.org`. + + ### Customizing DisposableVMs ### You can change the template used to generate the DisposableVMs, and change settings used in the DisposableVM savefile.