qubes-doc/UserDoc/DispVMCustomization.md
Zrubecz Laszlo 4f021da56c UserDoc/DispVMCustomization changed
added meaningful prompt to commands.
2014-07-31 10:53:44 +00:00

37 lines
1.8 KiB
Markdown

---
layout: wiki
title: DispVMCustomization
permalink: /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.")
``` {.wiki}
[user@dom0 ~]$ qvm-run -a fedora-20-x64-dvm gnome-terminal
```
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:
``` {.wiki}
[user@fedora-20-x64-dvm ~]$ touch /home/user/.qubes-dispvm-customized
```
4. Shutdown the VM (either by `poweroff` from VM terminal, or `qvm-shutdown` from dom0 terminal).
5. Regenerate the DispVM template:
``` {.wiki}
[user@dom0 ~]$ qvm-create-default-dvm --default-template --default-script
```
**Note:** All of the above requires at least qubes-core-vm \>= 2.1.2 installed in template.