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

   1 Debian and Ubuntu repositories
   2 ==============================
   3 Michael Stapelberg <michael@i3wm.org>
   4 September 2016
   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.
  11
  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
  19     Debian wheezy)].
  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
  27     repository.
  28
  29 == Ubuntu repository
  30
  31 === Stable releases
  32
  33 This Ubuntu repository is provided by sur5r and contains the latest stable
  34 release of i3. To use it, run the following commands:
  35
  36 ////////////////////////////////////////////////////////////////////////////////
  37 TODO: Replace dpkg -i with apt install ./ below after 2019-05.
  38 See https://github.com/i3/i3.github.io/pull/35
  39 ////////////////////////////////////////////////////////////////////////////////
  40
  41 ---------------------------------------------------------------------------------
  42 $ /usr/lib/apt/apt-helper download-file http://debian.sur5r.net/i3/pool/main/s/sur5r-keyring/sur5r-keyring_2018.01.30_all.deb keyring.deb SHA256:baa43dbbd7232ea2b5444cae238d53bebb9d34601cc000e82f11111b1889078a
  43 # dpkg -i ./keyring.deb
  44 # echo "deb http://debian.sur5r.net/i3/ $(grep '^DISTRIB_CODENAME=' /etc/lsb-release | cut -f2 -d=) universe" >> /etc/apt/sources.list.d/sur5r-i3.list
  45 # apt update
  46 # apt install i3
  47 ---------------------------------------------------------------------------------
  48
  49 All Ubuntu versions which are currently supported by Ubuntu itself are also supported by
  50 this repository. See link:https://wiki.ubuntu.com/Releases[Ubuntu releases] for details.
  51
  52 Packages for unsupported Ubuntu versions might exist but may disappear any time.
  53
  54 === Development releases
  55
  56 This Ubuntu repository contains packages which are automatically built a few
  57 minutes after every commit. To use it, run the following commands:
  58
  59 ---------------------------------------------------------------------------------
  60 $ /usr/lib/apt/apt-helper download-file http://dl.bintray.com/i3/i3-autobuild-ubuntu/pool/main/i/i3-autobuild-keyring/i3-autobuild-keyring_2016.10.01_all.deb keyring.deb SHA256:460e8c7f67a6ae7c3996cc8a5915548fe2fee9637b1653353ec62b954978d844
  61 # apt install ./keyring.deb
  62 # echo 'deb http://dl.bintray.com/i3/i3-autobuild-ubuntu xenial main' > /etc/apt/sources.list.d/i3-autobuild.list
  63 # apt update
  64 # apt install i3
  65 ---------------------------------------------------------------------------------
  66
  67 Development versions are only available for the latest version of Ubuntu, which
  68 is xenial at the moment.
  69
  70 == Debian repository
  71
  72 Our Debian repository contains packages which are automatically built a few
  73 minutes after every commit. To use it, run the following commands:
  74
  75 ---------------------------------------------------------------------------------
  76 $ /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
  77 # apt install ./keyring.deb
  78 # echo 'deb http://dl.bintray.com/i3/i3-autobuild sid main' > /etc/apt/sources.list.d/i3-autobuild.list
  79 # apt update
  80 # apt install i3
  81 ---------------------------------------------------------------------------------
  82
  83 == Preferring the autobuilder version of i3
  84
  85 On installations where you have multiple sources (stable and testing, or
  86 testing and unstable for example), +apt-get install i3+ might not get you the
  87 autobuilder version.
  88
  89 To ensure that the autobuilt i3 packages will be preferred to the packages of
  90 your distribution, create the file
  91 +/etc/apt/preferences.d/00-i3-autobuild.pref+ with the following contents:
  92
  93 ----------------------------
  94 Package: i3*
  95 Pin: origin "dl.bintray.com"
  96 Pin-Priority: 1001
  97 ----------------------------
  98
  99 Then, run +apt-get update+ and install +i3+.