From 56ed2bac0575db061221b4cd4ded210e07f21195 Mon Sep 17 00:00:00 2001 From: Daniel Mendler Date: Mon, 30 May 2016 10:42:53 +0200 Subject: [PATCH] i3 installation from testing repository See https://github.com/QubesOS/qubes-desktop-linux-i3/pull/1 --- customization/i3.md | 39 ++++++++++++++++++++++++--------------- 1 file changed, 24 insertions(+), 15 deletions(-) diff --git a/customization/i3.md b/customization/i3.md index ebe6bff2..00d17801 100644 --- a/customization/i3.md +++ b/customization/i3.md @@ -9,19 +9,27 @@ redirect_from: - "/wiki/UserDoc/i3/" --- -i3 installation in dom0 -======================== +# i3 installation in dom0 -Note that all of the work in this document is done in a Fedora based domU (could +i3 is part of the testing repository (as of Qubes R3.1) and can be installed from there +using the dom0 update mechanism. + + $ qubes-dom0-update --enablerepo=qubes-dom0-current-testing i3 + +Qubes-specific configuation is available in a separate package and can be installed +optionally. Otherwise you can write your own configuration (see below). + + $ qubes-dom0-update --enablerepo=qubes-dom0-current-testing i3-settings-qubes + +That's it. After logging out, you can select i3 in the login manager. + +## Compilation and installation from source + +Note that the compilation from source is done in a Fedora based domU (could be dispvm). The end result is always an `.rpm` that is copied to dom0 and then installed through the package manager. -**Warning:** Installing software in dom0 is inherently risky, and the method -described in this guide circumvents the usual security mechanisms for [updating -software in dom0](/doc/software-update-dom0/). - -Getting the code ----------------- +### Getting the code Clone the i3-qubes repository here: @@ -36,8 +44,7 @@ OS and changes some defaults so the user can't override decisions. If you want to make any changes to the package, this is the time and place to do it. -Building --------- +### Building You'll need to install the build dependencies, which are listed in build-deps.list. You can verify them and then install them with @@ -50,8 +57,9 @@ you get the sources and start off the build: $ make rpms -Installing ----------- +### Installing + +**Warning**: Manually installing software in dom0 is inherently risky, and the method described here circumvents the usual security mechanisms of qubes-dom0-update. You should now have your i3 rpm in `./rpm/x86_64/i3-4.8-3.fc20.x86_64.rpm`. Protip: copying this file to `~/i3.rpm` now will save you some typing in the @@ -74,8 +82,9 @@ After that you can just install the generated rpm like any other local package Log out, select i3, then log in again. -Configuration -------------- +### Configuration + +**Warning**: Be careful when writing configuration/scripts for the dom0. A script which communicates with the qubes VMs could potentially open a security hole. Things needed/recommended to be done: