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

   1 Debian and Ubuntu repositories
   2 ==============================
   3 Michael Stapelberg <michael+i3@stapelberg.de>
   4 November 2011
   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 You are using Ubuntu::
  19     Only a handful of packages are maintained by Ubuntu developers. The rest is
  20     synchronized periodically from Debian, every 6 months. Therefore, Ubuntu
  21     often includes old versions of i3. You should use our Ubuntu repository.
  22 You want the latest i3 development version::
  23     If you are using Debian (Debian-derived systems might work, too) or Ubuntu
  24     and want the latest development version of i3, you should use our Debian
  25     repository.
  26
  27 == Ubuntu repository
  28
  29 === Stable releases
  30
  31 This Ubuntu repository is provided by sur5r and contains the latest stable
  32 release of i3. To use it, run the following commands:
  33
  34 ---------------------------------------------------------------------------------
  35 # . /etc/lsb-release
  36 # echo "deb http://debian.sur5r.net/i3/ $DISTRIB_CODENAME universe" >> /etc/apt/sources.list
  37 # apt-get update
  38 # apt-get --allow-unauthenticated install sur5r-keyring
  39 # apt-get update
  40 # apt-get install i3
  41 ---------------------------------------------------------------------------------
  42
  43 The following Ubuntu versions are currently available: maverick, natty, oneiric,
  44 precise.
  45
  46 === Development releases
  47
  48 This Ubuntu repository contains packages which are automatically built a few
  49 minutes after every commit. To use it, run the following commands:
  50
  51 ---------------------------------------------------------------------------------
  52 # echo 'deb http://build.i3wm.org/ubuntu/oneiric oneiric main' >> /etc/apt/sources.list
  53 # apt-get update
  54 # apt-get --allow-unauthenticated install i3-autobuild-keyring
  55 # apt-get update
  56 # apt-get install i3
  57 ---------------------------------------------------------------------------------
  58
  59 Development versions are only available for the latest version of Ubuntu, which
  60 is oneiric at the moment.
  61
  62 == Debian repository
  63
  64 Our Debian repository contains packages which are automatically built a few
  65 minutes after every commit. To use it, run the following commands:
  66
  67 ---------------------------------------------------------------------------------
  68 # echo 'deb http://build.i3wm.org/debian/sid sid main' >> /etc/apt/sources.list
  69 # apt-get update
  70 # apt-get --allow-unauthenticated install i3-autobuild-keyring
  71 # apt-get update
  72 # apt-get install i3
  73 ---------------------------------------------------------------------------------
  74
  75 == Preferring the autobuilder version of i3
  76
  77 On installations where you have multiple sources (stable and testing, or
  78 testing and unstable for example), +apt-get install i3+ might not get you the
  79 autobuilder version.
  80
  81 To ensure that the autobuilt i3 packages will be preferred to the packages of
  82 your distribution, put the following entry *at the beginning* of your
  83 +/etc/apt/preferences+:
  84
  85 ----------------------------
  86 Package: *
  87 Pin: origin "build.i3wm.org"
  88 Pin-Priority: 1001
  89 ----------------------------
  90
  91 Then, install +i3+.