]> git.sur5r.net Git - i3/i3.github.io/blobdiff - docs/repositories.html
repositories: authenticated installation instructions for ubuntu
[i3/i3.github.io] / docs / repositories.html
index 66bacd4c31e8464f9f4d847062189539f0880266..3db334e09895ce455c9ee20389fda66a64c57bd0 100644 (file)
@@ -2,15 +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/png" href="/favicon.png">\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
@@ -22,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">November 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
@@ -50,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
@@ -63,7 +66,7 @@ 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
@@ -84,14 +87,15 @@ You want the latest i3 development version
 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/ $(lsb_release -c -s) universe" &gt;&gt; /etc/apt/sources.list\r
-# apt-get update\r
-# apt-get --allow-unauthenticated install sur5r-keyring\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_2017.01.02_all.deb keyring.deb SHA256:4c3c6685b1181d83efe3a479c5ae38a2a44e23add55e16a328b8c8560bf05e5f\r
+# apt install ./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>The following Ubuntu versions are currently available: maverick, natty, oneiric,\r
-precise.</p></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
@@ -99,14 +103,14 @@ precise.</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/ubuntu/oneiric oneiric main' &gt;&gt; /etc/apt/sources.list\r
-# apt-get update\r
-# apt-get --allow-unauthenticated install i3-autobuild-keyring\r
-# apt-get update\r
-# apt-get install i3</tt></pre>\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 oneiric at the moment.</p></div>\r
+is xenial at the moment.</p></div>\r
 </div>\r
 </div>\r
 </div>\r
@@ -117,11 +121,11 @@ is oneiric at the moment.</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/sid sid main' &gt;&gt; /etc/apt/sources.list\r
-# apt-get update\r
-# apt-get --allow-unauthenticated install i3-autobuild-keyring\r
-# apt-get update\r
-# apt-get install i3</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
@@ -132,15 +136,15 @@ minutes after every commit. To use it, run the following commands:</p></div>
 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</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