Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2025-08-01 11:06:28 -04:00
Code Issues Projects Releases Packages Wiki Activity

basics and customization fenced blocks replaced with standard markdown

Browse source
This commit is contained in:
Jeepler 2015-09-23 18:41:20 +02:00
parent cbdd6e00ab
commit b65aa75876
4 changed files with 33 additions and 57 deletions
Download patch file Download diff file Expand all files Collapse all files

34
customization/DispVMCustomization.md
View file

@ -14,21 +14,20 @@ You may want to use a non-default template as a basis for Disposable VM. One exa
In order to regenerate the Disposable VM "snapshot" (called 'savefile' on Qubes) one can use the following command in Dom0:
```
[joanna@dom0 ~]$ qvm-create-default-dvm <custom-template-name>
```
[joanna@dom0 ~]$ qvm-create-default-dvm <custom-template-name>
This would create a new Disposable VM savefile based on the custom template. Now, whenever one opens a file (from any AppVM) in a Disposable VM, a Disposable VM based on this template will be used.
One can easily verify if the new Disposable VM template is indeed based on a custom template (in the example below the template called "f17-yellow" was used as a basis for the Disposable VM):
```
[joanna@dom0 ~]$ ll /var/lib/qubes/dvmdata/
total 0
lrwxrwxrwx 1 joanna joanna 45 Mar 11 13:59 default_dvm.conf -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm.conf
lrwxrwxrwx 1 joanna joanna 49 Mar 11 13:59 default_savefile -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm-savefile
lrwxrwxrwx 1 joanna joanna 47 Mar 11 13:59 savefile_root -> /var/lib/qubes/vm-templates/f17-yellow/root.img
```
[joanna@dom0 ~]$ ll /var/lib/qubes/dvmdata/
total 0
lrwxrwxrwx 1 joanna joanna 45 Mar 11 13:59 default_dvm.conf -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm.conf
lrwxrwxrwx 1 joanna joanna 49 Mar 11 13:59 default_savefile -> /var/lib/qubes/appvms/f17-yellow-dvm/dvm-savefile
lrwxrwxrwx 1 joanna joanna 47 Mar 11 13:59 savefile_root -> /var/lib/qubes/vm-templates/f17-yellow/root.img
Customization of Disposable VM
@ -38,9 +37,8 @@ It is possible to change the settings of each new Disposable VM (DispVM). This c
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.")
```
[user@dom0 ~]$ qvm-run -a fedora-20-x64-dvm gnome-terminal
```
[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.
@ -49,15 +47,13 @@ It is possible to change the settings of each new Disposable VM (DispVM). This c
3. Create an empty `/home/user/.qubes-dispvm-customized` file:
```
[user@fedora-20-x64-dvm ~]$ touch /home/user/.qubes-dispvm-customized
```
[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:
```
[user@dom0 ~]$ qvm-create-default-dvm --default-template --default-script
```
[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.

12
customization/XFCE.md
View file

@ -18,15 +18,11 @@ Requirements (as of 10/24/2012):
Installation:
```
qubes-dom0-update --enablerepo=qubes-dom0-unstable @XFCE
```
qubes-dom0-update --enablerepo=qubes-dom0-unstable @XFCE
Then you need to create /etc/sysconfig/desktop to stay with KDM, as GDM still starts invalid Xorg startup script:
```
DISPLAYMANAGER=KDE
```
DISPLAYMANAGER=KDE
Reboot the system. At system startup, select "Xfce session" in login screen (menu on the right bottom corner of the screen).
@ -39,7 +35,6 @@ Things needs/recommended to be done:
- create own favorites menu (currently standard XFCE menu isn't modified to use per-VM subsections, which makes it very inconvenient):
1. create \~/.config/menus/favorites.menu, example content:
```
<!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu 1.0//EN"
"http://www.freedesktop.org/standards/menu-spec/1.0/menu.dtd">
@ -60,8 +55,5 @@ Things needs/recommended to be done:
<Filename>untrusted-firefox.desktop</Filename>
</Include>
</Menu>
```
2. add it to the panel: right click on panel, "add new items", select "XFCE menu", choose custom menu file - just created one