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 squeeze, lenny,

15) Debian sid, or Debian testing</a></h2>
16) <br />
17) 
18) <p>

19) If you're using Debian, just run<br />

20) <tt>apt-get install tor tor-geoipdb</tt>
21) as root.
22) </p>
23) 
24) <p>
25) Note that this might not always give you the latest stable Tor version, but
26) you will receive important security fixes. To make sure that you're running
27) the latest stable version of Tor, see option two below.
28) </p>
29) 
30) <p>
31) Now Tor is installed and running. Move on to <a href="<page

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

33) instructions.
34) </p>
35) 
36) <hr />
37) 
38) <a id="ubuntu"></a>
39) <a id="packages"></a>
40) <h2><a class="anchor" href="#ubuntu">Option two: Tor on Ubuntu or
41) Debian</a></h2>
42) <br />
43) 
44) <p>

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

48) </p>
49) 
50) <p>
51) You'll need to set up our package repository before you can fetch

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

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

55) <ul>

56) <li> Debian unstable (sid) is "sid"</li>

57) <li> Debian testing is "wheezy"</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) </ul>
66) 
67) Then add this line to your
68) <tt>/etc/apt/sources.list</tt>
69) file:<br />
70) <pre>
71) deb     http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
72) </pre>

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

75) in place of <DISTRIBUTION>.

76) </p>
77) 
78) <p>
79) Then add the gpg key used to sign the packages by running the following
80) commands at your command prompt:
81) <pre>
82) gpg --keyserver keys.gnupg.net --recv 886DDD89
83) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
84) </pre>

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

87) <pre>
88) apt-get update

89) </pre>
90) If there are no errors you're good to continue.
91) </p>
92) 
93) <p>
94) We provide a Debian package to help you keep our signing key current.  It is
95) recommended you use it.  Install it using
96) <pre>
97) apt-get install deb.torproject.org-keyring
98) </pre>
99) </p>
100) 
101) <p>
102) To finally install Tor just run:
103) <pre>
104) apt-get install tor

105) </pre>
106) </p>
107) 
108) <p>
109) Now Tor is installed and running. Move on to <a href="<page

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

111) instructions.
112) </p>
113) 
114) <p style="font-size: small">
115) The DNS name <code>deb.torproject.org</code> is actually a set of independent
116) servers in a DNS round robin configuration.  If you for some reason cannot
117) access it you might try to use the name of one of its part instead.  Try
118) <code>deb-master.torproject.org</code>,
119) <code>mirror.netcologne.de</code> or
120) <code>tor.mirror.youam.de</code>.
121) </p>
122) 
123) <hr />
124) 
125) <a id="development"></a>
126) <h2><a class="anchor" href="#development">Option three: Using the
127) development branch of Tor on Debian or Ubuntu</a></h2>
128) <br />
129) 

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

134) <pre>
135) deb     http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
136) deb     http://deb.torproject.org/torproject.org experimental-&lt;DISTRIBUTION&gt; main
137) </pre>

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

140) <DISTRIBUTION>.

141) </p>
142) 
143) <p>
144) Then run the following commands at your command prompt:
145) <pre>
146) gpg --keyserver keys.gnupg.net --recv 886DDD89
147) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
148) apt-get update
149) apt-get install tor tor-geoipdb
150) </pre>
151) </p>
152) 
153) <p>
154) Now Tor is installed and running. Move on to <a href="<page

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

156) instructions.
157) </p>
158) 
159) <hr />
160) 
161) <a id="source"></a>
162) <h2><a class="anchor" href="#source">Building from source</a></h2>
163) <br />
164) 
165) <p>
166) If you want to build your own debs from source you must first add an
167) appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.
168) <pre>
169) # For the stable version.
170) deb-src http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
171) 
172) # For the unstable version.
173) deb-src http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
174) deb-src http://deb.torproject.org/torproject.org experimental-&lt;DISTRIBUTION&gt; main
175) </pre>
176) You also need to install the necessary packages to build your own debs and the
177) packages needed to build Tor:
178) <pre>
179) apt-get install build-essential fakeroot devscripts
180) apt-get build-dep tor
181) </pre>
182) Then you can build Tor in ~/debian-packages:
183) <pre>
184) mkdir ~/debian-packages; cd ~/debian-packages
185) apt-get source tor
186) cd tor-*
187) debuild -rfakeroot -uc -us
188) cd ..
189) </pre>
190) Now you can install the new package:
191) <pre>
192) sudo dpkg -i tor_*.deb
193) </pre>
194) </p>
195) 
196) <p>
197) Now Tor is installed and running. Move on to <a href="<page

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

199) instructions.
200) </p>
201) 
202) <hr />
203) 
204) <p>If you have suggestions for improving this document, please <a
205) href="<page about/contact>">send them to us</a>. Thanks!</p>
206) 
207) <!-- END MAIN COL -->