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) <div id="content" class="clearfix">
7)   <div id="breadcrumbs">

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

9)     <a href="<page docs/documentation>">Documentation &raquo; </a>
10)     <a href="<page docs/debian>">Debian/Ubuntu Instructions</a>
11)   </div>
12)   <div id="maincol"> 

13) <a id="debian"></a>
14) <h2><a class="anchor" href="#debian">Option one: Tor on Debian lenny,
15) Debian sid, or Debian testing</a></h2>
16) <br />
17) 
18) <p>
19) If you're using Debian stable (lenny), unstable (sid), or testing
20) (squeeze), just run<br />
21) <tt>apt-get install tor tor-geoipdb</tt>
22) as root.
23) </p>
24) 
25) <p>
26) Note that this might not always give you the latest stable Tor version, but
27) you will receive important security fixes. To make sure that you're running
28) the latest stable version of Tor, see option two below.
29) </p>
30) 
31) <p>
32) Now Tor is installed and running. Move on to <a href="<page
33) docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
34) instructions.
35) </p>
36) 
37) <hr />
38) 
39) <a id="ubuntu"></a>
40) <a id="packages"></a>
41) <h2><a class="anchor" href="#ubuntu">Option two: Tor on Ubuntu or
42) Debian</a></h2>
43) <br />
44) 
45) <p>
46) <b>Do not use the packages in Ubuntu's universe.</b> They are unmaintained
47) and out of date. That means you'll be missing stability and security
48) fixes.
49) </p>
50) 
51) <p>
52) You'll need to set up our package repository before you can fetch

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

54) quick command to run is <tt>lsb_release -c</tt> or <tt>cat /etc/debian_version</tt>.
55) Here's a quick mapping:

56) <ul>

57) <li> Debian unstable (sid) is "sid"</li>
58) <li> Debian 6.0 (squeeze) is "squeeze"</li>
59) <li> Debian 5.0 (lenny) is "lenny"</li>

60) <li> Ubuntu 11.04 is "natty"</li>
61) <li> Ubuntu 10.10 or Trisquel 4.5 is "maverick"</li>

62) <li> Ubuntu 10.04 or Trisquel 4.0 is "lucid"</li>
63) <li> Ubuntu 9.10 or Trisquel 3.5 is  "karmic"</li>

64) <li> Ubuntu 8.04 is "hardy"</li>
65) <li> Ubuntu 6.06 is "dapper"</li>

66) </ul>
67) 
68) Then add this line to your
69) <tt>/etc/apt/sources.list</tt>
70) file:<br />
71) <pre>
72) deb     http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
73) </pre>

74) where you put the codename of your distribution (i.e. lenny, sid,
75) maverick or whatever it is)

76) in place of <DISTRIBUTION>.

77) </p>
78) 
79) <p>
80) Then add the gpg key used to sign the packages by running the following
81) commands at your command prompt:
82) <pre>
83) gpg --keyserver keys.gnupg.net --recv 886DDD89
84) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
85) </pre>
86) Now refresh your sources and install Tor by running the following
87) commands (as root) at your command prompt:
88) <pre>
89) apt-get update
90) apt-get install tor tor-geoipdb
91) </pre>
92) </p>
93) 
94) <p>
95) Now Tor is installed and running. Move on to <a href="<page
96) docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
97) instructions.
98) </p>
99) 
100) <p style="font-size: small">
101) The DNS name <code>deb.torproject.org</code> is actually a set of independent
102) servers in a DNS round robin configuration.  If you for some reason cannot
103) access it you might try to use the name of one of its part instead.  Try
104) <code>deb-master.torproject.org</code>,
105) <code>mirror.netcologne.de</code> or
106) <code>tor.mirror.youam.de</code>.
107) </p>
108) 
109) <hr />
110) 
111) <a id="development"></a>
112) <h2><a class="anchor" href="#development">Option three: Using the
113) development branch of Tor on Debian or Ubuntu</a></h2>
114) <br />
115) 

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

120) <pre>
121) deb     http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
122) deb     http://deb.torproject.org/torproject.org experimental-&lt;DISTRIBUTION&gt; main
123) </pre>

124) where you again substitute the name of your distro (lenny,
125) sid, maverick, ...) in place of

126) <DISTRIBUTION>.

127) </p>
128) 
129) <p>
130) Then run the following commands at your command prompt:
131) <pre>
132) gpg --keyserver keys.gnupg.net --recv 886DDD89
133) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
134) apt-get update
135) apt-get install tor tor-geoipdb
136) </pre>
137) </p>
138) 
139) <p>
140) Now Tor is installed and running. Move on to <a href="<page
141) docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
142) instructions.
143) </p>
144) 
145) <hr />
146) 
147) <a id="source"></a>
148) <h2><a class="anchor" href="#source">Building from source</a></h2>
149) <br />
150) 
151) <p>
152) If you want to build your own debs from source you must first add an
153) appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.
154) <pre>
155) # For the stable version.
156) deb-src http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
157) 
158) # For the unstable version.
159) deb-src http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
160) deb-src http://deb.torproject.org/torproject.org experimental-&lt;DISTRIBUTION&gt; main
161) </pre>
162) You also need to install the necessary packages to build your own debs and the
163) packages needed to build Tor:
164) <pre>
165) apt-get install build-essential fakeroot devscripts
166) apt-get build-dep tor
167) </pre>
168) Then you can build Tor in ~/debian-packages:
169) <pre>
170) mkdir ~/debian-packages; cd ~/debian-packages
171) apt-get source tor
172) cd tor-*
173) debuild -rfakeroot -uc -us
174) cd ..
175) </pre>
176) Now you can install the new package:
177) <pre>
178) sudo dpkg -i tor_*.deb
179) </pre>
180) </p>
181) 
182) <p>
183) Now Tor is installed and running. Move on to <a href="<page
184) docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
185) instructions.
186) </p>
187) 
188) <hr />
189) 
190) <p>If you have suggestions for improving this document, please <a
191) href="<page about/contact>">send them to us</a>. Thanks!</p>
192) 
193) <!-- END MAIN COL -->