diff --git a/UserDoc/DispVMCustomization.md b/UserDoc/DispVMCustomization.md index 21c1fd5f..c9a9050c 100644 --- a/UserDoc/DispVMCustomization.md +++ b/UserDoc/DispVMCustomization.md @@ -7,26 +7,30 @@ permalink: /wiki/UserDoc/DispVMCustomization/ Customization of Disposable VM ============================== -It is possible to change application settings for each new DispVM. This can be done by customizin DispVM template: +It is possible to change the settings of each new Disposable VM (DispVM). This can be done by customizing the DispVM template: -1. Start terminal in 'fedora-18-x64-dvm' VM (via command line, it is not listed in Qubes Manager nor system menu): +1. Start a terminal in the `fedora-18-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} qvm-run -a fedora-18-x64-dvm gnome-terminal ``` -2. Change application settings (eg you can start firefox and change default search engine, install some plugins etc). -3. Create empty /home/user/.qubes-dispvm-customized file: +2. Change the VM's settings and/or applications, as desired. Note that currently Qubes supports exactly on 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} touch /home/user/.qubes-dispvm-customized ``` -4. Shutdown the VM (either by poweroff from VM terminal, or qvm-shutdown from dom0 terminal). -5. Regenerate DispVM template: +4. Shutdown the VM (either by `poweroff` from VM terminal, or `qvm-shutdown` from dom0 terminal). +5. Regenerate the DispVM template: ``` {.wiki} qvm-create-default-dvm --default-template --default-script ``` -**Note:** All above require at least qubes-core-vm \>= 2.1.2 installed in template. +**Note:** All of the above requires at least qubes-core-vm \>= 2.1.2 installed in template.