]> git.sur5r.net Git - i3/i3.github.io/blob - docs/repositories.html
943165dfaea9fab0118454f6c87b3fb7d7eda4af
[i3/i3.github.io] / docs / repositories.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
2     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
4 <head>\r
5 <link rel="icon" type="image/png" href="/favicon.png">\r
6 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
7 <meta name="generator" content="AsciiDoc 8.6.4" />\r
8 <title>i3: Debian and Ubuntu repositories</title>\r
9 <link rel="stylesheet" href="/css/style.css" type="text/css" />\r
10 <link rel="stylesheet" href="/css/xhtml11.css" type="text/css" />\r
11 <script type="text/javascript">\r
12 /*<![CDATA[*/\r
13 window.onload = function(){asciidoc.footnotes();}\r
14 /*]]>*/\r
15 </script>\r
16 <script type="text/javascript" src="/js/asciidoc-xhtml11.js"></script>\r
17 </head>\r
18 <body class="article">\r
19 \r
20         <div id="main">\r
21             <a href="/"><h1 id="title">i3 - improved tiling WM</h1></a>\r
22                         <ul id="nav">\r
23                                 <li><a style="border-bottom: 2px solid #fff" href="/docs">Docs</a></li>\r
24                                 <li><a href="/screenshots">Screens</a></li>\r
25                                 <li><a href="/contact">Contact</a></li>\r
26                                 <li><a href="http://bugs.i3wm.org/">Bugs</a></li>\r
27                         </ul>\r
28         <br style="clear: both">\r
29 <div id="content">\r
30 <div id="header">\r
31 <h1>Debian and Ubuntu repositories</h1>\r
32 <span id="author">Michael Stapelberg</span><br />\r
33 <span id="email"><tt>&lt;<a href="mailto:michael+i3@stapelberg.de">michael+i3@stapelberg.de</a>&gt;</tt></span><br />\r
34 <span id="revdate">November 2011</span>\r
35 </div>\r
36 <div class="sect1">\r
37 <h2 id="_when_should_you_use_our_repositories">1. When should you use our repositories?</h2>\r
38 <div class="sectionbody">\r
39 <div class="paragraph"><p>In general, you should use the repositories of your distribution. Adding\r
40 third-party repositories to your <tt>/etc/sources.list</tt> has security implications\r
41 and makes your <tt>apt-get update</tt> take longer. However, in some cases, using our\r
42 repositories makes sense:</p></div>\r
43 <div class="dlist"><dl>\r
44 <dt class="hdlist1">\r
45 You are using Debian stable\r
46 </dt>\r
47 <dd>\r
48 <p>\r
49     The latest version of i3 will be in Debian testing quite soon. The version\r
50     in Debian stable can be old, however (we cannot update it after stable has\r
51     been released). The best way is to add Debian testing and tell <tt>apt</tt> to\r
52     prefer Debian stable. You should <strong>not</strong> use our repository.\r
53 </p>\r
54 </dd>\r
55 <dt class="hdlist1">\r
56 You are using Ubuntu\r
57 </dt>\r
58 <dd>\r
59 <p>\r
60     Only a handful of packages are maintained by Ubuntu developers. The rest is\r
61     synchronized periodically from Debian, every 6 months. Therefore, Ubuntu\r
62     often includes old versions of i3. You should use our Ubuntu repository.\r
63 </p>\r
64 </dd>\r
65 <dt class="hdlist1">\r
66 You want the latest i3 development version\r
67 </dt>\r
68 <dd>\r
69 <p>\r
70     If you are using Debian (Debian-derived systems might work, too) or Ubuntu\r
71     and want the latest development version of i3, you should use our Debian\r
72     repository.\r
73 </p>\r
74 </dd>\r
75 </dl></div>\r
76 </div>\r
77 </div>\r
78 <div class="sect1">\r
79 <h2 id="_ubuntu_repository">2. Ubuntu repository</h2>\r
80 <div class="sectionbody">\r
81 <div class="sect2">\r
82 <h3 id="_stable_releases">2.1. Stable releases</h3>\r
83 <div class="paragraph"><p>This Ubuntu repository is provided by sur5r and contains the latest stable\r
84 release of i3. To use it, run the following commands:</p></div>\r
85 <div class="listingblock">\r
86 <div class="content">\r
87 <pre><tt># echo 'deb http://debian.sur5r.net/i3/ natty universe' &gt;&gt; /etc/apt/sources.list\r
88 # apt-get update\r
89 # apt-get --allow-unauthenticated install sur5r-keyring\r
90 # apt-get update\r
91 # apt-get install i3</tt></pre>\r
92 </div></div>\r
93 <div class="paragraph"><p>The following Ubuntu versions are currently available: maverick, natty, oneiric,\r
94 precise.</p></div>\r
95 </div>\r
96 <div class="sect2">\r
97 <h3 id="_development_releases">2.2. Development releases</h3>\r
98 <div class="paragraph"><p>This Ubuntu repository contains packages which are automatically built a few\r
99 minutes after every commit. To use it, run the following commands:</p></div>\r
100 <div class="listingblock">\r
101 <div class="content">\r
102 <pre><tt># echo 'deb http://build.i3wm.org/ubuntu/oneiric oneiric main' &gt;&gt; /etc/apt/sources.list\r
103 # apt-get update\r
104 # apt-get --allow-unauthenticated install i3-autobuild-keyring\r
105 # apt-get update\r
106 # apt-get install i3</tt></pre>\r
107 </div></div>\r
108 <div class="paragraph"><p>Development versions are only available for the latest version of Ubuntu, which\r
109 is oneiric at the moment.</p></div>\r
110 </div>\r
111 </div>\r
112 </div>\r
113 <div class="sect1">\r
114 <h2 id="_debian_repository">3. Debian repository</h2>\r
115 <div class="sectionbody">\r
116 <div class="paragraph"><p>Our Debian repository contains packages which are automatically built a few\r
117 minutes after every commit. To use it, run the following commands:</p></div>\r
118 <div class="listingblock">\r
119 <div class="content">\r
120 <pre><tt># echo 'deb http://build.i3wm.org/debian/sid sid main' &gt;&gt; /etc/apt/sources.list\r
121 # apt-get update\r
122 # apt-get --allow-unauthenticated install i3-autobuild-keyring\r
123 # apt-get update\r
124 # apt-get install i3</tt></pre>\r
125 </div></div>\r
126 </div>\r
127 </div>\r
128 <div class="sect1">\r
129 <h2 id="_preferring_the_autobuilder_version_of_i3">4. Preferring the autobuilder version of i3</h2>\r
130 <div class="sectionbody">\r
131 <div class="paragraph"><p>On installations where you have multiple sources (stable and testing, or\r
132 testing and unstable for example), <tt>apt-get install i3</tt> might not get you the\r
133 autobuilder version.</p></div>\r
134 <div class="paragraph"><p>To ensure that the autobuilt i3 packages will be preferred to the packages of\r
135 your distribution, put the following entry <strong>at the beginning</strong> of your\r
136 <tt>/etc/apt/preferences</tt>:</p></div>\r
137 <div class="listingblock">\r
138 <div class="content">\r
139 <pre><tt>Package: *\r
140 Pin: origin "build.i3wm.org"\r
141 Pin-Priority: 1001</tt></pre>\r
142 </div></div>\r
143 <div class="paragraph"><p>Then, install <tt>i3</tt>.</p></div>\r
144 </div>\r
145 </div>\r
146 </div>\r
147 <div id="footnotes"><hr /></div>\r
148 <div id="footer" lang="de">\r
149 © 2009-2011 Michael Stapelberg, <a href="/impress.html">Impressum</a>\r
150 </div>\r
151 </body>\r
152 </html>\r