qubes-doc/UserDoc/DispVMCustomization.md

layout	title	permalink	redirect_from
doc	DispVMCustomization	/doc/UserDoc/DispVMCustomization/	/wiki/UserDoc/DispVMCustomization/

Customization of Disposable VM

It is possible to change the settings of each new Disposable VM (DispVM). This can be done by customizing the DispVM template:

1. Start a terminal in the fedora-20-x64-dvm TemplateVM by running the following command in a dom0 terminal. (By default, this TemplateVM is not shown in Qubes VM Manager. However, it can be shown by selecting "Show/Hide internal VMs.")

   {% highlight trac-wiki %} [user@dom0 ~]$ qvm-run -a fedora-20-x64-dvm gnome-terminal {% endhighlight %}

2. Change the VM's settings and/or applications, as desired. Note that currently Qubes supports exactly one DispVM template, so any changes you make here will affect all DispVMs. Some examples of changes you may want to make include:

   • Changing Firefox's default startup settings and homepage.
   • Changing Nautilus' default file preview settings.
   • Changing the DispVM's default NetVM. For example, you may wish to set the NetVM to "none." Then, whenever you start a new DispVM, you can choose your desired ProxyVM manually (by changing the newly-started DipsVMs settings). This is useful if you sometimes wish to use a DispVM with a TorVM, for example. It is also useful if you sometimes wish to open untrusted files in a network-disconnected DispVM.

3. Create an empty /home/user/.qubes-dispvm-customized file:

   {% highlight trac-wiki %} [user@fedora-20-x64-dvm ~]$ touch /home/user/.qubes-dispvm-customized {% endhighlight %}

4. Shutdown the VM (either by poweroff from VM terminal, or qvm-shutdown from dom0 terminal).

5. Regenerate the DispVM template:

   {% highlight trac-wiki %} [user@dom0 ~]$ qvm-create-default-dvm --default-template --default-script {% endhighlight %}

Note: All of the above requires at least qubes-core-vm >= 2.1.2 installed in template.