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) and want
  24     the latest development version of i3, you should use our Debian repository.
  25
  26 == Ubuntu repository
  27
  28 The Ubuntu repository is provided by sur5r and contains the latest stable release
  29 of i3. To use it, run the following commands:
  30
  31 ---------------------------------------------------------------------------------
  32 # echo 'deb http://debian.sur5r.net/i3/ natty universe' >> /etc/apt/sources.list
  33 # apt-get update
  34 # apt-get --allow-unauthenticated install sur5r-keyring
  35 # apt-get update
  36 # apt-get install i3
  37 ---------------------------------------------------------------------------------
  38
  39 The following Ubuntu versions are currently available: maverick, natty, oneiric,
  40 precise.
  41
  42 == Debian repository
  43
  44 Our Debian repository contains packages which are automatically built a few
  45 minutes after every commit. To use it, run the following commands:
  46
  47 ---------------------------------------------------------------------------------
  48 # echo 'deb http://build.i3wm.org/debian/i3-wm sid main' >> /etc/apt/sources.list
  49 # apt-get update
  50 # apt-get install i3-wm
  51 ---------------------------------------------------------------------------------
  52
  53 To ensure that the autobuilt i3 packages will be preferred to the packages of
  54 your distribution, put the following entry *at the beginning* of your
  55 +/etc/apt/preferences+:
  56
  57 ----------------------------
  58 Package: *
  59 Pin: origin "build.i3wm.org"
  60 Pin-Priority: 1001
  61 ----------------------------
  62
  63 Then, install +i3-wm+.