]> git.sur5r.net Git - i3/i3.github.io/blobdiff - docs/4.16/repositories.html
save docs for 4.16
[i3/i3.github.io] / docs / 4.16 / repositories.html
diff --git a/docs/4.16/repositories.html b/docs/4.16/repositories.html
new file mode 100644 (file)
index 0000000..7e2416e
--- /dev/null
@@ -0,0 +1,156 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
+    "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.10" />\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
+document.addEventListener("DOMContentLoaded", function(){asciidoc.footnotes();}, false);\r
+/*]]>*/\r
+</script>\r
+<script type="text/javascript" src="/js/asciidoc-xhtml11.js"></script>\r
+</head>\r
+<body class="article">\r
+\r
+        <div id="main">\r
+            <a href="/"><h1 id="title">i3 - improved tiling WM</h1></a>\r
+                        <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="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@i3wm.org">michael@i3wm.org</a>&gt;</tt></span><br />\r
+<span id="revdate">November 2018</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.</p></div>\r
+<div class="dlist"><dl>\r
+<dt class="hdlist1">\r
+If you are using Debian stable\r
+</dt>\r
+<dd>\r
+<p>\r
+    The latest version of i3 will be in Debian testing quite soon. The version\r
+    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
+If you are using Ubuntu\r
+</dt>\r
+<dd>\r
+<p>\r
+    Only a handful of packages are maintained by Ubuntu developers. The rest is\r
+    synchronized periodically from Debian, every 6 months. Therefore, Ubuntu\r
+    often includes old versions of i3. You should use our Ubuntu repository.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\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) 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
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_ubuntu_repository">2. Ubuntu repository</h2>\r
+<div class="sectionbody">\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>$ /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 bionic 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 bionic at the moment.</p></div>\r
+</div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_debian_repository">3. Debian repository</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph"><p>Our Debian 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/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, 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: i3*\r
+Pin: origin "dl.bintray.com"\r
+Pin-Priority: 1001</tt></pre>\r
+</div></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
+<div id="footnotes"><hr /></div>\r
+<div id="footer" lang="de">\r
+© 2009-2011 Michael Stapelberg, <a href="/impress.html">Impressum</a>\r
+</div>\r
+</body>\r
+</html>\r