tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 3-low
4) 
5) #include "head.wmi" TITLE="Tor Project: Debian/Ubuntu Instructions" CHARSET="UTF-8"

6) 
7) <script>
8) <!--
9) // This code is based on the http://mozilla.debian.net sources.list
10) // generator as originally written by Mike Hommey. It is licensed under
11) // the terms of the GNU GPLv2, http://www.gnu.org/licenses/gpl-2.0.html.
12) var sources = {};
13) var software = {

14) 'tor': { '_stable': { 'squeeze': [ 'squeeze' ],

15)                      'wheezy':  [ 'wheezy' ],
16)                      'jessie':  [ 'jessie' ],

17)                      'stretch': [ 'stretch' ],

18)                      'sid':     [ 'sid' ],
19)                      'lucid':   [ 'lucid'],
20)                      'precise': [ 'precise'],
21)                      'saucy':   [ 'saucy'],
22)                      'trusty':  [ 'trusty'],
23)                      'utopic':  [ 'utopic'] },

24)          'experimental-0.2.7.x':    { 'wheezy':  [ 'wheezy' ],

25)                      'jessie':  [ 'jessie' ],

26)                      'stretch': [ 'stretch' ],

27)                      'sid':     [ 'sid' ],
28)                      'lucid':   [ 'lucid'],
29)                      'precise': [ 'precise'],
30)                      'saucy':   [ 'saucy'],
31)                      'trusty':  [ 'trusty'],
32)                      'utopic':  [ 'utopic'] },
33)        },

34) 'tor (from source)': { '_stable': { 'squeeze': [ 'squeeze' ],

35)                      'wheezy':  [ 'wheezy' ],
36)                      'jessie':  [ 'jessie' ],

37)                      'stretch': [ 'stretch' ],

38)                      'sid':     [ 'sid' ],
39)                      'lucid':   [ 'lucid'],
40)                      'precise': [ 'precise'],
41)                      'saucy':   [ 'saucy'],
42)                      'trusty':  [ 'trusty'],
43)                      'utopic':  [ 'utopic'] },

44)          'experimental-0.2.7.x':    { 'wheezy':  [ 'wheezy' ],

45)                      'jessie':  [ 'jessie' ],

46)                      'stretch': [ 'stretch' ],

47)                      'sid':     [ 'sid' ],
48)                      'lucid':   [ 'lucid'],
49)                      'precise': [ 'precise'],
50)                      'saucy':   [ 'saucy'],
51)                      'trusty':  [ 'trusty'],
52)                      'utopic':  [ 'utopic'] },
53)        },
54) };
55) 
56) function init() {
57)     pkg = document.getElementById('package');
58)     for (soft in software) {
59)         if (soft != pkg.value) {
60)             option = document.createElement('option');
61)             option.value = soft;
62)             option.appendChild(document.createTextNode(soft.charAt(0).toUpperCase() + soft.slice(1)));
63)             pkg.appendChild(option);
64)         }
65)     }
66) 
67)     apt_get = document.getElementById('apt-get');
68)     para = document.createElement('p');
69)     para.id = 'sorry';
70)     para.style.display = 'none';
71)     apt_get.parentNode.insertBefore(para, apt_get);
72)     para.appendChild(document.createTextNode("Sorry, this version is not available.\n"));
73) 
74)     document.getElementById('selector').style.display = 'block';
75) 
76)     update();
77) }
78) 
79) function replaceText(src, txt) {
80)     while (src.firstChild)
81)         src.removeChild(src.firstChild);
82)     src.appendChild(document.createTextNode(txt));
83) }
84) 
85) function update() {
86)     pkg = document.getElementById('package');
87)     ver = document.getElementById('version');
88)     package = pkg.value;
89)     version = ver.value;
90)     distrib = document.getElementById('distrib').value;
91)     if (package != pkg.prev) {
92)         while (ver.firstChild)
93)             ver.removeChild(ver.firstChild);

94)         var selected;

95)         for (version in software[package]) {
96)             option = document.createElement('option');
97)             if (version[0] == '_') {
98)                 version = version.slice(1);

99)                 selected = version;

100)             }
101)             option.appendChild(document.createTextNode(version));
102)             option.value = version = version.replace(/ \(.*\)/,'');
103) //alert(version);
104)             ver.appendChild(option);
105)         }

106)         ver.value = version = selected || version;

107)         pkg.prev = package
108)     }
109)     try {
110)         keys = software[package][version][distrib];
111)     } catch (e) {
112)         try {
113)             keys = software[package]['_' + version][distrib];
114)         } catch (e) { };
115)     }
116)     src = document.getElementById('sources');
117)     txt = '';
118)     need_signed = false;
119)     source_install = false;
120)     target = '';
121)     for (i = 0; keys && (i < keys.length); i++) {
122) //alert(keys[i]);
123)         if (keys[i] in sources) {
124)             txt += sources[keys[i]];
125)             target = keys[i];
126)         } else {
127)             if (package.slice(-7, -1) == 'source') {
128)                 package = package.split(' ')[0];

129)                 source_install = true;

130)             }

131)             txt += "http://deb.torproject.org/torproject.org";

132)             txt += " ";
133)             txt += keys[i];
134)             txt += " main";
135)             need_signed = true;
136)             target = keys[i];

137)             txt = "deb " + txt + "\ndeb-src " + txt;

138)             if (version != 'stable') {
139)                 txt2 = "http://deb.torproject.org/torproject.org";
140)                 txt2 += " ";
141)                 txt2 += package;
142)                 txt2 += "-";
143)                 txt2 += version;
144)                 txt2 += "-";
145)                 txt2 += keys[i];
146)                 txt2 += " main";
147)                 txt = txt + "\ndeb " + txt2 + "\ndeb-src " + txt2;
148)             }

149)         }
150)         txt += "\n";
151)     }
152)     replaceText(src, txt);
153)     document.getElementById('regular-install').style.display = source_install ? 'none' : 'block';
154)     document.getElementById('source-install').style.display = source_install ? 'block' : 'none';
155)     document.getElementById('source-install2').style.display = source_install ? 'block' : 'none';
156)     replaceText(document.getElementById('apt-package'), package);
157)     document.getElementById('apt-source').style.display = (keys && keys.length) ? 'block' : 'none';
158)     document.getElementById('apt-get').style.display = keys ? 'block' : 'none';
159)     document.getElementById('sorry').style.display = keys ? 'none' : 'block';
160) }
161) 
162) window.onload = init;
163) 
164) -->
165) </script>
166) 
167) 
168) 

169) <div id="content" class="clearfix">
170)   <div id="breadcrumbs">

171)     <a href="<page index>">Home &raquo; </a>

172)     <a href="<page docs/documentation>">Documentation &raquo; </a>
173)     <a href="<page docs/debian>">Debian/Ubuntu Instructions</a>
174)   </div>

175)   <div id="maincol">

176) <a id="debian"></a>

177) <h2><a class="anchor" href="#debian">Option one: Tor on Debian stable,

178) Debian sid, or Debian testing</a></h2>
179) <br />
180) 
181) <p>

182) If you're using Debian, just run
183) </blockquote><pre>  apt-get install tor </pre></blockquote>

184) as root.
185) </p>
186) 
187) <p>
188) Note that this might not always give you the latest stable Tor version, but
189) you will receive important security fixes. To make sure that you're running
190) the latest stable version of Tor, see option two below.
191) </p>
192) 
193) <p>
194) Now Tor is installed and running. Move on to <a href="<page

195) docs/tor-doc-unix>#using">step two</a> of the "Tor on Linux/Unix"

196) instructions.
197) </p>
198) 
199) <hr />
200) 
201) <a id="ubuntu"></a>
202) <a id="packages"></a>
203) <h2><a class="anchor" href="#ubuntu">Option two: Tor on Ubuntu or
204) Debian</a></h2>
205) <br />
206) 
207) <p>

208) <b>Do not use the packages in Ubuntu's universe.</b> In the past they have
209) not reliably been updated. That means you could be missing stability
210) and security fixes.

211) </p>
212) 

213) <p>
214) <b>Raspbian is not Debian.</b> These packages will be confusingly broken
215) for Raspbian users, since Raspbian called their architecture armhf but

216) Debian already has an armhf. See <a
217) href="http://tor.stackexchange.com/questions/242/how-to-run-tor-on-raspbian-on-the-raspberry-pi">this
218) post</a> for details.

219) </p>
220) 

221) <p>
222) You'll need to set up our package repository before you can fetch

223) Tor. First, you need to figure out the name of your distribution. A

224) quick command to run is <tt>lsb_release -c</tt> or <tt>cat /etc/debian_version</tt>.

225) If in doubt about your Debian version, check <a href="http://www.debian.org/releases/">the Debian website</a>.
226) For Ubuntu, ask <a href="https://en.wikipedia.org/wiki/List_of_Ubuntu_releases#Table_of_versions">Wikipedia</a>.

227) </p>
228) 
229) <div id="selector" style="display: none;">
230) <blockquote>

231) I run

232) <select id="distrib" onchange="update()">

233) <option value="squeeze">Debian oldoldstable (Squeeze)</option>

234) <option value="wheezy">Debian oldstable (Wheezy)</option>
235) <option value="jessie" selected="selected">Debian (Jessie)</option>

236) <option value="sid">Debian unstable (sid)</option>

237) <option value="lucid">Ubuntu Lucid Lynx</option>
238) <option value="precise">Ubuntu Precise Pangolin</option>
239) <option value="saucy">Ubuntu Saucy Salamander</option>
240) <option value="trusty">Ubuntu Trusty Tahr</option>
241) <option value="utopic">Ubuntu Utopic Unicorn</option>
242) </select>

243) and want

244) <select id="package" onchange="update()"></select>
245) version
246) <select id="version" onchange="update()"></select>
247) </blockquote>
248) 
249) 
250) <div id="apt-source">
251) <p>You need to add the following entry in <code>/etc/apt/sources.list</code> or a new file in <code>/etc/apt/sources.list.d/</code>:</p>
252) 
253) <blockquote><pre id="sources">deb http://deb.torproject.org/torproject.org wheezy main
254) </pre></blockquote>
255) </div>

256) 

257) <div id="sig">
258) <p>Then add the gpg key used to sign the packages by running the following commands at your command prompt:</p>
259) <blockquote><pre>
260) gpg --keyserver keys.gnupg.net --recv 886DDD89
261) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
262) </pre></blockquote>
263) </div>
264) 
265) 
266) <div id="apt-get">
267) <p>You can install it with the following commands:</p>
268) <blockquote><pre>$ apt-get update
269) <span id="regular-install">$ apt-get install <span id="apt-package">tor</span> deb.torproject.org-keyring</span>
270) <span id="source-install">$ apt-get install build-essential fakeroot devscripts
271) $ apt-get build-dep tor deb.torproject.org-keyring</span></pre></blockquote>
272) 
273) <div id="source-install2">
274) <p>
275) Then you can build Tor in ~/debian-packages:
276) </p>
277) <blockquote><pre>
278) $ mkdir ~/debian-packages; cd ~/debian-packages
279) $ apt-get source tor
280) $ cd tor-*
281) $ debuild -rfakeroot -uc -us
282) $ cd ..
283) </pre></blockquote>
284) <p>Now you can install the new package:</p>
285) <blockquote><pre>
286) $ sudo dpkg -i tor_*.deb
287) </pre></blockquote>
288) </div>
289) </div>
290) </div>
291) 
292) <noscript>
293) <p>

294) Then add this line to your
295) <tt>/etc/apt/sources.list</tt>
296) file:<br />

297) <pre style="margin: 1.5em 0 1.5em 2em">

298) deb     http://deb.torproject.org/torproject.org <DISTRIBUTION> main
299) </pre>

300) where you put the codename of your distribution (i.e. lenny, sid,

301) saucy or whatever it is)

302) in place of <DISTRIBUTION>.

303) </p>
304) 
305) <p>
306) Then add the gpg key used to sign the packages by running the following
307) commands at your command prompt:

308) <pre style="margin: 1.5em 0 1.5em 2em">

309) gpg --keyserver keys.gnupg.net --recv 886DDD89
310) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
311) </pre>

312) Now refresh your sources, running the following command (as root) at your
313) command prompt:

314) <pre style="margin: 1.5em 0 1.5em 2em">

315) apt-get update

316) </pre>
317) If there are no errors you're good to continue.
318) </p>
319) 
320) <p>
321) We provide a Debian package to help you keep our signing key current.  It is
322) recommended you use it.  Install it using

323) <pre style="margin: 1.5em 0 1.5em 2em">

324) apt-get install deb.torproject.org-keyring
325) </pre>
326) </p>
327) 
328) <p>
329) To finally install Tor just run:

330) <pre style="margin: 1.5em 0 1.5em 2em">

331) apt-get install tor

332) </pre>
333) </p>
334) 

335) </noscript>
336) 

337) <p>
338) Now Tor is installed and running. Move on to <a href="<page

339) docs/tor-doc-unix>#using">step two</a> of the "Tor on Linux/Unix"

340) instructions.
341) </p>
342) 

343) <noscript>

344) <p style="font-size: small">
345) The DNS name <code>deb.torproject.org</code> is actually a set of independent
346) servers in a DNS round robin configuration.  If you for some reason cannot
347) access it you might try to use the name of one of its part instead.  Try
348) <code>deb-master.torproject.org</code>,
349) <code>mirror.netcologne.de</code> or
350) <code>tor.mirror.youam.de</code>.
351) </p>
352) 
353) <hr />
354) 
355) <a id="development"></a>
356) <h2><a class="anchor" href="#development">Option three: Using the
357) development branch of Tor on Debian or Ubuntu</a></h2>
358) <br />
359) 

360) <p>If you want to use the <a href="<page
361) download/download>#packagediff">development branch</a> of Tor instead
362) (more features and more bugs), you need to add a different set of lines
363) to your <tt>/etc/apt/sources.list</tt> file:<br />

364) <pre style="margin: 1.5em 0 1.5em 2em">

365) deb     http://deb.torproject.org/torproject.org <DISTRIBUTION> main

366) deb     http://deb.torproject.org/torproject.org tor-experimental-0.2.6.x-<DISTRIBUTION> main

367) </pre>

368) where you again substitute the name of your distro (lenny,

369) sid, saucy, ...) in place of

370) <DISTRIBUTION>.

371) </p>
372) 
373) <p>
374) Then run the following commands at your command prompt:

375) <pre style="margin: 1.5em 0 1.5em 2em">

376) gpg --keyserver keys.gnupg.net --recv 886DDD89
377) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
378) apt-get update

379) apt-get install tor deb.torproject.org-keyring

380) </pre>
381) </p>
382) 
383) <p>
384) Now Tor is installed and running. Move on to <a href="<page

385) docs/tor-doc-unix>#using">step two</a> of the "Tor on Linux/Unix"

386) instructions.
387) </p>
388) 
389) <hr />
390) 
391) <a id="source"></a>
392) <h2><a class="anchor" href="#source">Building from source</a></h2>
393) <br />
394) 
395) <p>
396) If you want to build your own debs from source you must first add an
397) appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.

398) <pre style="margin: 1.5em 0 1.5em 2em">

399) # For the stable version.
400) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main
401) 
402) # For the unstable version.
403) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main

404) deb-src http://deb.torproject.org/torproject.org tor-experimental-0.2.6.x-<DISTRIBUTION> main

405) </pre>

406) Substitute the name of your distro (wheezy, sid, trusty, ...) in place of <DISTRIBUTION>. Now refresh your sources by running (as root):
407) <pre style="margin: 1.5em 0 1.5em 2em">
408) apt-get update
409) </pre>
410) You also need to install the necessary packages to build your own debs and the 

411) packages needed to build Tor:

412) <pre style="margin: 1.5em 0 1.5em 2em">

413) apt-get install build-essential fakeroot devscripts
414) apt-get build-dep tor
415) </pre>
416) Then you can build Tor in ~/debian-packages:

417) <pre style="margin: 1.5em 0 1.5em 2em">

418) mkdir ~/debian-packages; cd ~/debian-packages
419) apt-get source tor
420) cd tor-*
421) debuild -rfakeroot -uc -us
422) cd ..
423) </pre>
424) Now you can install the new package:

425) <pre style="margin: 1.5em 0 1.5em 2em">

426) sudo dpkg -i tor_*.deb
427) </pre>
428) </p>
429) 
430) <p>
431) Now Tor is installed and running. Move on to <a href="<page

432) docs/tor-doc-unix>#using">step two</a> of the "Tor on Linux/Unix"

433) instructions.
434) </p>

435) </noscript>

436) 
437) <!-- END MAIN COL -->