git.sur5r.net Git - i3/i3.github.io/blob - _docs/repositories

   1 Debian and Ubuntu repositories
   2 ==============================
   3 Michael Stapelberg <michael@i3wm.org>
   4 July 2013
   5
   6 == When should you use our repositories?
   7
   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. However, in some cases, using our
  11 repositories makes sense:
  12
  13 You are using Debian stable::
  14     The latest version of i3 will be in Debian testing quite soon. The version
  15     in Debian stable can be old, however (we cannot update it after stable has
  16     been released). The best way is to add Debian testing and tell +apt+ to
  17     prefer Debian stable. You should *not* use our repository.
  18     Alternatively, you can also use
  19     link:http://backports.debian.org/[stable-backports (e.g. wheezy-backports for
  20     Debian wheezy)].
  21 You are using Ubuntu::
  22     Only a handful of packages are maintained by Ubuntu developers. The rest is
  23     synchronized periodically from Debian, every 6 months. Therefore, Ubuntu
  24     often includes old versions of i3. You should use our Ubuntu repository.
  25 You want the latest i3 development version::
  26     If you are using Debian (Debian-derived systems might work, too) or Ubuntu
  27     and want the latest development version of i3, you should use our Debian
  28     repository.
  29
  30 == Ubuntu repository
  31
  32 === Stable releases
  33
  34 This Ubuntu repository is provided by sur5r and contains the latest stable
  35 release of i3. To use it, run the following commands:
  36
  37 ---------------------------------------------------------------------------------
  38 # echo "deb http://debian.sur5r.net/i3/ $(lsb_release -c -s) universe" >> /etc/apt/sources.list
  39 # apt-get update
  40 # apt-get --allow-unauthenticated install sur5r-keyring
  41 # apt-get update
  42 # apt-get install i3
  43 ---------------------------------------------------------------------------------
  44
  45 All Ubuntu versions which are currently supported by Ubuntu itself are also supported by
  46 this repository. See link:https://wiki.ubuntu.com/Releases[Ubuntu releases] for details.
  47
  48 Packages for unsupported Ubuntu versions might exist but may disappear any time.
  49
  50 === Development releases
  51
  52 This Ubuntu repository contains packages which are automatically built a few
  53 minutes after every commit. To use it, run the following commands:
  54
  55 ---------------------------------------------------------------------------------
  56 # echo 'deb http://build.i3wm.org/ubuntu/trusty trusty main' >> /etc/apt/sources.list
  57 # apt-get update
  58 # apt-get --allow-unauthenticated install i3-autobuild-keyring
  59 # apt-get update
  60 # apt-get install i3
  61 ---------------------------------------------------------------------------------
  62
  63 Development versions are only available for the latest version of Ubuntu, which
  64 is trusty at the moment.
  65
  66 == Debian repository
  67
  68 Our Debian repository contains packages which are automatically built a few
  69 minutes after every commit. To use it, run the following commands:
  70
  71 ---------------------------------------------------------------------------------
  72 # echo 'deb http://build.i3wm.org/debian/sid sid main' > /etc/apt/sources.list.d/i3-autobuild.list
  73 # apt-get update
  74 # apt-get --allow-unauthenticated install i3-autobuild-keyring
  75 # apt-get update
  76 # apt-get install i3
  77 ---------------------------------------------------------------------------------
  78
  79 == Preferring the autobuilder version of i3
  80
  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
  83 autobuilder version.
  84
  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:
  88
  89 ----------------------------
  90 Package: i3*
  91 Pin: origin "build.i3wm.org"
  92 Pin-Priority: 1001
  93 ----------------------------
  94
  95 Then, run +apt-get update+ and install +i3+.