1. When should you use our repositories?
+In general, you should use the repositories of your distribution. Adding +third-party repositories to your /etc/sources.list has security implications +and makes your apt-get update take longer. However, in some cases, using our +repositories makes sense:
-
+
- +You are using Debian stable + +
-
+
+ The latest version of i3 will be in Debian testing quite soon. The version + in Debian stable can be old, however (we cannot update it after stable has + been released). The best way is to add Debian testing and tell apt to + prefer Debian stable. You should not use our repository. + Alternatively, you can also use + stable-backports (e.g. wheezy-backports for + Debian wheezy). +
+
+ - +You are using Ubuntu + +
-
+
+ Only a handful of packages are maintained by Ubuntu developers. The rest is + synchronized periodically from Debian, every 6 months. Therefore, Ubuntu + often includes old versions of i3. You should use our Ubuntu repository. +
+
+ - +You want the latest i3 development version + +
-
+
+ If you are using Debian (Debian-derived systems might work, too) or Ubuntu + and want the latest development version of i3, you should use our Debian + repository. +
+
+
2. Ubuntu repository
+2.1. Stable releases
+This Ubuntu repository is provided by sur5r and contains the latest stable +release of i3. To use it, run the following commands:
# echo "deb http://debian.sur5r.net/i3/ $(lsb_release -c -s) universe" >> /etc/apt/sources.list +# apt-get update +# apt-get --allow-unauthenticated install sur5r-keyring +# apt-get update +# apt-get install i3+
All Ubuntu versions which are currently supported by Ubuntu itself are also supported by +this repository. See Ubuntu releases for details.
Packages for unsupported Ubuntu versions might exist but may disappear any time.
2.2. Development releases
+This Ubuntu repository contains packages which are automatically built a few +minutes after every commit. To use it, run the following commands:
# echo 'deb http://build.i3wm.org/ubuntu/trusty trusty main' >> /etc/apt/sources.list +# apt-get update +# apt-get --allow-unauthenticated install i3-autobuild-keyring +# apt-get update +# apt-get install i3+
Development versions are only available for the latest version of Ubuntu, which +is trusty at the moment.
3. Debian repository
+Our Debian repository contains packages which are automatically built a few +minutes after every commit. To use it, run the following commands:
# echo 'deb http://build.i3wm.org/debian/sid sid main' > /etc/apt/sources.list.d/i3-autobuild.list +# apt-get update +# apt-get --allow-unauthenticated install i3-autobuild-keyring +# apt-get update +# apt-get install i3+
4. Preferring the autobuilder version of i3
+On installations where you have multiple sources (stable and testing, or +testing and unstable for example), apt-get install i3 might not get you the +autobuilder version.
To ensure that the autobuilt i3 packages will be preferred to the packages of +your distribution, create the file +/etc/apt/preferences.d/00-i3-autobuild.pref with the following contents:
Package: i3* +Pin: origin "build.i3wm.org" +Pin-Priority: 1001+
Then, run apt-get update and install i3.