Debian and Ubuntu repositories
==============================
Michael Stapelberg <michael@i3wm.org>
-July 2013
+November 2018
== When should you use our repositories?
In general, you should use the repositories of your distribution. Adding
third-party repositories to your +/etc/sources.list+ has security implications
-and makes your +apt-get update+ take longer. However, in some cases, using our
-repositories makes sense:
+and makes your +apt-get update+ take longer.
-You are using Debian stable::
+If you are using Debian stable::
The latest version of i3 will be in Debian testing quite soon. The version
in Debian stable can be old, however (we cannot update it after stable has
been released). The best way is to add Debian testing and tell +apt+ to
Alternatively, you can also use
link:http://backports.debian.org/[stable-backports (e.g. wheezy-backports for
Debian wheezy)].
-You are using Ubuntu::
+If you are using Ubuntu::
Only a handful of packages are maintained by Ubuntu developers. The rest is
synchronized periodically from Debian, every 6 months. Therefore, Ubuntu
often includes old versions of i3. You should use our Ubuntu repository.
-You want the latest i3 development version::
+If you want the latest i3 development version::
If you are using Debian (Debian-derived systems might work, too) or Ubuntu
and want the latest development version of i3, you should use our Debian
repository.
This Ubuntu repository is provided by sur5r and contains the latest stable
release of i3. To use it, run the following commands:
+////////////////////////////////////////////////////////////////////////////////
+TODO: Replace dpkg -i with apt install ./ below after 2019-05.
+See https://github.com/i3/i3.github.io/pull/35
+////////////////////////////////////////////////////////////////////////////////
+
---------------------------------------------------------------------------------
-# echo "deb http://debian.sur5r.net/i3/ $(lsb_release -c -s) universe" >> /etc/apt/sources.list
-# apt-get update
-# apt-get --allow-unauthenticated install sur5r-keyring
-# apt-get update
-# apt-get install i3
+$ /usr/lib/apt/apt-helper download-file http://debian.sur5r.net/i3/pool/main/s/sur5r-keyring/sur5r-keyring_2019.02.01_all.deb keyring.deb SHA256:176af52de1a976f103f9809920d80d02411ac5e763f695327de9fa6aff23f416
+# dpkg -i ./keyring.deb
+# 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
+# apt update
+# apt install i3
---------------------------------------------------------------------------------
All Ubuntu versions which are currently supported by Ubuntu itself are also supported by
minutes after every commit. To use it, run the following commands:
---------------------------------------------------------------------------------
-# echo 'deb http://build.i3wm.org/ubuntu/trusty trusty main' >> /etc/apt/sources.list
-# apt-get update
-# apt-get --allow-unauthenticated install i3-autobuild-keyring
-# apt-get update
-# apt-get install i3
+$ /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
+# apt install ./keyring.deb
+# echo 'deb http://dl.bintray.com/i3/i3-autobuild-ubuntu bionic main' > /etc/apt/sources.list.d/i3-autobuild.list
+# apt update
+# apt install i3
---------------------------------------------------------------------------------
Development versions are only available for the latest version of Ubuntu, which
-is trusty at the moment.
+is bionic at the moment.
== Debian repository
minutes after every commit. To use it, run the following commands:
---------------------------------------------------------------------------------
-# echo 'deb http://build.i3wm.org/debian/sid sid main' > /etc/apt/sources.list.d/i3-autobuild.list
-# apt-get update
-# apt-get --allow-unauthenticated install i3-autobuild-keyring
-# apt-get update
-# apt-get install i3
+$ /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
+# apt install ./keyring.deb
+# echo 'deb http://dl.bintray.com/i3/i3-autobuild sid main' > /etc/apt/sources.list.d/i3-autobuild.list
+# apt update
+# apt install i3
---------------------------------------------------------------------------------
== Preferring the autobuilder version of i3
----------------------------
Package: i3*
-Pin: origin "build.i3wm.org"
+Pin: origin "dl.bintray.com"
Pin-Priority: 1001
----------------------------