1 Debian and Ubuntu repositories
2 ==============================
3 Michael Stapelberg <michael@i3wm.org>
6 == When should you use our repositories?
8 In general, you should use the repositories of your distribution. Adding
9 third-party repositories to your +/etc/sources.list+ has security implications
10 and makes your +apt-get update+ take longer.
12 If you are using Debian stable::
13 The latest version of i3 will be in Debian testing quite soon. The version
14 in Debian stable can be old, however (we cannot update it after stable has
15 been released). The best way is to add Debian testing and tell +apt+ to
16 prefer Debian stable. You should *not* use our repository.
17 Alternatively, you can also use
18 link:http://backports.debian.org/[stable-backports (e.g. wheezy-backports for
20 If you are using Ubuntu::
21 Only a handful of packages are maintained by Ubuntu developers. The rest is
22 synchronized periodically from Debian, every 6 months. Therefore, Ubuntu
23 often includes old versions of i3. You should use our Ubuntu repository.
24 If you want the latest i3 development version::
25 If you are using Debian (Debian-derived systems might work, too) or Ubuntu
26 and want the latest development version of i3, you should use our Debian
33 This Ubuntu repository is provided by sur5r and contains the latest stable
34 release of i3. To use it, run the following commands:
36 ---------------------------------------------------------------------------------
37 # echo "deb http://debian.sur5r.net/i3/ $(lsb_release -c -s) universe" >> /etc/apt/sources.list
39 # apt-get --allow-unauthenticated install sur5r-keyring
42 ---------------------------------------------------------------------------------
44 All Ubuntu versions which are currently supported by Ubuntu itself are also supported by
45 this repository. See link:https://wiki.ubuntu.com/Releases[Ubuntu releases] for details.
47 Packages for unsupported Ubuntu versions might exist but may disappear any time.
49 === Development releases
51 This Ubuntu repository contains packages which are automatically built a few
52 minutes after every commit. To use it, run the following commands:
54 ---------------------------------------------------------------------------------
55 # echo 'deb http://dl.bintray.com/i3/i3-autobuild-ubuntu xenial main' > /etc/apt/sources.list.d/i3-autobuild.list
57 # apt-get --allow-unauthenticated install i3-autobuild-keyring
58 # rm -f /var/lib/apt/lists/dl.bintray.com_i3_i3-autobuild-ubuntu_*
61 ---------------------------------------------------------------------------------
63 Development versions are only available for the latest version of Ubuntu, which
64 is xenial at the moment.
68 Our Debian repository contains packages which are automatically built a few
69 minutes after every commit. To use it, run the following commands:
71 ---------------------------------------------------------------------------------
72 $ /usr/lib/apt/apt-helper download-file http://dl.bintray.com/i3/i3-autobuild/pool/main/i/i3-autobuild-keyring/i3-autobuild-keyring_2016.10.01_all.deb keyring.deb SHA256:460e8c7f67a6ae7c3996cc8a5915548fe2fee9637b1653353ec62b954978d844
73 # apt install ./keyring.deb
74 # echo 'deb http://dl.bintray.com/i3/i3-autobuild sid main' > /etc/apt/sources.list.d/i3-autobuild.list
77 ---------------------------------------------------------------------------------
79 == Preferring the autobuilder version of i3
81 On installations where you have multiple sources (stable and testing, or
82 testing and unstable for example), +apt-get install i3+ might not get you the
85 To ensure that the autobuilt i3 packages will be preferred to the packages of
86 your distribution, create the file
87 +/etc/apt/preferences.d/00-i3-autobuild.pref+ with the following contents:
89 ----------------------------
91 Pin: origin "dl.bintray.com"
93 ----------------------------
95 Then, run +apt-get update+ and install +i3+.