]> git.sur5r.net Git - i3/i3.github.io/blobdiff - docs/repositories.html
repositories: update debian.sur5r.net keyring (#44)
[i3/i3.github.io] / docs / repositories.html
index f11e5361833f8fa18450b9d783d4e8e981843a04..02c7941ffd5dadf3f07596b7aa7953d093972e1c 100644 (file)
@@ -2,14 +2,15 @@
     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
 <head>\r
+<link rel="icon" type="image/x-icon" href="/favicon.ico">\r
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 8.6.4" />\r
+<meta name="generator" content="AsciiDoc 8.6.9" />\r
 <title>i3: Debian and Ubuntu repositories</title>\r
 <link rel="stylesheet" href="/css/style.css" type="text/css" />\r
 <link rel="stylesheet" href="/css/xhtml11.css" type="text/css" />\r
 <script type="text/javascript">\r
 /*<![CDATA[*/\r
-window.onload = function(){asciidoc.footnotes();}\r
+document.addEventListener("DOMContentLoaded", function(){asciidoc.footnotes();}, false);\r
 /*]]>*/\r
 </script>\r
 <script type="text/javascript" src="/js/asciidoc-xhtml11.js"></script>\r
@@ -21,27 +22,27 @@ window.onload = function(){asciidoc.footnotes();}
                         <ul id="nav">\r
                                 <li><a style="border-bottom: 2px solid #fff" href="/docs">Docs</a></li>\r
                                 <li><a href="/screenshots">Screens</a></li>\r
+                                <li><a href="https://www.reddit.com/r/i3wm/">FAQ</a></li>\r
                                 <li><a href="/contact">Contact</a></li>\r
-                                <li><a href="http://bugs.i3wm.org/">Bugs</a></li>\r
+                                <li><a href="https://github.com/i3/i3/issues">Bugs</a></li>\r
                         </ul>\r
         <br style="clear: both">\r
 <div id="content">\r
 <div id="header">\r
 <h1>Debian and Ubuntu repositories</h1>\r
 <span id="author">Michael Stapelberg</span><br />\r
-<span id="email"><tt>&lt;<a href="mailto:michael+i3@stapelberg.de">michael+i3@stapelberg.de</a>&gt;</tt></span><br />\r
-<span id="revdate">July 2011</span>\r
+<span id="email"><tt>&lt;<a href="mailto:michael@i3wm.org">michael@i3wm.org</a>&gt;</tt></span><br />\r
+<span id="revdate">September 2016</span>\r
 </div>\r
 <div class="sect1">\r
 <h2 id="_when_should_you_use_our_repositories">1. When should you use our repositories?</h2>\r
 <div class="sectionbody">\r
 <div class="paragraph"><p>In general, you should use the repositories of your distribution. Adding\r
 third-party repositories to your <tt>/etc/sources.list</tt> has security implications\r
-and makes your <tt>apt-get update</tt> take longer. However, in some cases, using our\r
-repositories makes sense:</p></div>\r
+and makes your <tt>apt-get update</tt> take longer.</p></div>\r
 <div class="dlist"><dl>\r
 <dt class="hdlist1">\r
-You are using Debian stable\r
+If you are using Debian stable\r
 </dt>\r
 <dd>\r
 <p>\r
@@ -49,10 +50,13 @@ You are using Debian stable
     in Debian stable can be old, however (we cannot update it after stable has\r
     been released). The best way is to add Debian testing and tell <tt>apt</tt> to\r
     prefer Debian stable. You should <strong>not</strong> use our repository.\r
+    Alternatively, you can also use\r
+    <a href="http://backports.debian.org/">stable-backports (e.g. wheezy-backports for\r
+    Debian wheezy)</a>.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-You are using Ubuntu\r
+If you are using Ubuntu\r
 </dt>\r
 <dd>\r
 <p>\r
@@ -62,12 +66,13 @@ You are using Ubuntu
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
-You want the latest i3 development version\r
+If you want the latest i3 development version\r
 </dt>\r
 <dd>\r
 <p>\r
-    If you are using Debian (Debian-derived systems might work, too) and want\r
-    the latest development version of i3, you should use our Debian repository.\r
+    If you are using Debian (Debian-derived systems might work, too) or Ubuntu\r
+    and want the latest development version of i3, you should use our Debian\r
+    repository.\r
 </p>\r
 </dd>\r
 </dl></div>\r
@@ -76,14 +81,37 @@ You want the latest i3 development version
 <div class="sect1">\r
 <h2 id="_ubuntu_repository">2. Ubuntu repository</h2>\r
 <div class="sectionbody">\r
-<div class="paragraph"><p>The Ubuntu repository is provided by sur5r and contains the latest stable release\r
-of i3. To use it, run the following commands:</p></div>\r
+<div class="sect2">\r
+<h3 id="_stable_releases">2.1. Stable releases</h3>\r
+<div class="paragraph"><p>This Ubuntu repository is provided by sur5r and contains the latest stable\r
+release of i3. To use it, run the following commands:</p></div>\r
 <div class="listingblock">\r
 <div class="content">\r
-<pre><tt># echo 'deb http://debian.sur5r.net/i3/ karmic universe' &gt;&gt; /etc/apt/sources.list\r
-# apt-get update\r
-# apt-get install i3</tt></pre>\r
+<pre><tt>$ /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\r
+# dpkg -i ./keyring.deb\r
+# echo "deb http://debian.sur5r.net/i3/ $(grep '^DISTRIB_CODENAME=' /etc/lsb-release | cut -f2 -d=) universe" &gt;&gt; /etc/apt/sources.list.d/sur5r-i3.list\r
+# apt update\r
+# apt install i3</tt></pre>\r
 </div></div>\r
+<div class="paragraph"><p>All Ubuntu versions which are currently supported by Ubuntu itself are also supported by\r
+this repository. See <a href="https://wiki.ubuntu.com/Releases">Ubuntu releases</a> for details.</p></div>\r
+<div class="paragraph"><p>Packages for unsupported Ubuntu versions might exist but may disappear any time.</p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_development_releases">2.2. Development releases</h3>\r
+<div class="paragraph"><p>This Ubuntu repository contains packages which are automatically built a few\r
+minutes after every commit. To use it, run the following commands:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>$ /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\r
+# apt install ./keyring.deb\r
+# echo 'deb http://dl.bintray.com/i3/i3-autobuild-ubuntu xenial main' &gt; /etc/apt/sources.list.d/i3-autobuild.list\r
+# apt update\r
+# apt install i3</tt></pre>\r
+</div></div>\r
+<div class="paragraph"><p>Development versions are only available for the latest version of Ubuntu, which\r
+is xenial at the moment.</p></div>\r
+</div>\r
 </div>\r
 </div>\r
 <div class="sect1">\r
@@ -93,20 +121,30 @@ of i3. To use it, run the following commands:</p></div>
 minutes after every commit. To use it, run the following commands:</p></div>\r
 <div class="listingblock">\r
 <div class="content">\r
-<pre><tt># echo 'deb http://build.i3wm.org/debian/i3-wm sid main' &gt;&gt; /etc/apt/sources.list\r
-# apt-get update\r
-# apt-get install i3-wm</tt></pre>\r
+<pre><tt>$ /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\r
+# apt install ./keyring.deb\r
+# echo 'deb http://dl.bintray.com/i3/i3-autobuild sid main' &gt; /etc/apt/sources.list.d/i3-autobuild.list\r
+# apt update\r
+# apt install i3</tt></pre>\r
 </div></div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_preferring_the_autobuilder_version_of_i3">4. Preferring the autobuilder version of i3</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph"><p>On installations where you have multiple sources (stable and testing, or\r
+testing and unstable for example), <tt>apt-get install i3</tt> might not get you the\r
+autobuilder version.</p></div>\r
 <div class="paragraph"><p>To ensure that the autobuilt i3 packages will be preferred to the packages of\r
-your distribution, put the following entry <strong>at the beginning</strong> of your\r
-<tt>/etc/apt/preferences</tt>:</p></div>\r
+your distribution, create the file\r
+<tt>/etc/apt/preferences.d/00-i3-autobuild.pref</tt> with the following contents:</p></div>\r
 <div class="listingblock">\r
 <div class="content">\r
-<pre><tt>Package: *\r
-Pin: origin "build.i3wm.org"\r
+<pre><tt>Package: i3*\r
+Pin: origin "dl.bintray.com"\r
 Pin-Priority: 1001</tt></pre>\r
 </div></div>\r
-<div class="paragraph"><p>Then, install <tt>i3-wm</tt>.</p></div>\r
+<div class="paragraph"><p>Then, run <tt>apt-get update</tt> and install <tt>i3</tt>.</p></div>\r
 </div>\r
 </div>\r
 </div>\r