tor-webwml.git

1) ## translation metadata
2) # Revision: $Revision: 19802 $
3) # Translation-Priority: 3-low
4) 
5) #include "head.wmi" TITLE="Tor: Debian/Ubuntu Instructions"
6) 
7) <div class="center">
8) 
9) <div class="main-column">
10) 
11) <a id="debian"></a>
12) <h2><a class="anchor" href="#debian">Option one: Tor on Debian lenny,
13) Debian sid, or Debian testing</a></h2>
14) <br />
15) 
16) <p>
17) If you're using Debian stable (lenny), unstable (sid), or testing
18) (squeeze), just run<br />
19) <tt>apt-get install tor tor-geoipdb</tt>
20) </p>
21) 

22) <p>
23) Note that this might not always give you the latest stable Tor version, but
24) you will receive important security fixes. To make sure that you're running
25) the latest stable version of Tor, see option two below.
26) </p>
27) 

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

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

31) instructions.
32) </p>
33) 
34) <hr />
35) 
36) <a id="ubuntu"></a>
37) <a id="packages"></a>
38) <h2><a class="anchor" href="#ubuntu">Option two: Tor on Ubuntu or

39) Debian</a></h2>

40) <br />
41) 
42) <p>
43) <b>Do not use the packages in Ubuntu's universe.</b> They are unmaintained
44) and out of date. That means you'll be missing stability and security
45) fixes.
46) </p>
47) 
48) <p>
49) You'll need to set up our package repository before you can fetch
50) Tor. First, you need to figure out the name of your distribution. If
51) you're using Ubuntu 9.04, it's "jaunty". Ubuntu 8.10 is "intrepid",

52) and Ubuntu 8.04 is "hardy". If you're using Debian Etch, it's "etch", Debian
53) Lenny is "lenny". Then add this line to your <tt>/etc/apt/sources.list</tt>
54) file:<br />

55) <pre>

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

57) </pre>

58) where you substitute the above word (etch, lenny, sid, jaunty, intrepid,
59) hardy) in place of <DISTRIBUTION>.

60) </p>
61) 

62) <p>
63) We don't currently have Ubuntu 9.10 (Karmic Koala) packages, but the packages
64) for Debian sid work. Instead of putting "karmic" in your sources.list line,
65) use "sid".
66) </p>
67) 

68) <p>
69) Then run
70) <pre>

71) gpg --keyserver keys.gnupg.net --recv 886DDD89
72) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -

73) apt-get update
74) apt-get install tor tor-geoipdb
75) </pre>

76) </p>

77) 
78) <p>
79) Now Tor is installed and running. Move on to <a href="<page

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

81) instructions.
82) </p>
83) 

84) <p style="font-size: small">
85) The DNS name <code>deb.torproject.org</code> is actually a set of independent
86) servers in a DNS round robin configuration.  If you for some reason cannot
87) access it you might try to use the name of one of its part instead.  Try
88) <code>deb-master.torproject.org</code>,
89) <code>mirror.netcologne.de</code> or
90) <code>tor.mirror.youam.de</code>.
91) </p>
92) 

93) <hr />
94) 
95) <a id="development"></a>
96) <h2><a class="anchor" href="#development">Option three: Using the
97) development branch of Tor on Debian or Ubuntu</a></h2>
98) <br />
99) 
100) <p>If you want to use the <a href="<page
101) download>#packagediff">development branch</a> of Tor instead (more
102) features and more bugs), you need to add a different set of lines to
103) your <tt>/etc/apt/sources.list</tt> file:<br />
104) <pre>

105) deb     http://deb.torproject.org/torproject.org <DISTRIBUTION> main
106) deb     http://deb.torproject.org/torproject.org experimental-<DISTRIBUTION> main

107) </pre>
108) where you substitute the name of your distro (etch, lenny, sid, jaunty,
109) intrepid, hardy) in place of &lt;DISTRIBUTION&gt;.
110) </p>
111) 
112) <p>
113) Then run
114) <pre>

115) gpg --keyserver keys.gnupg.net --recv 886DDD89
116) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -

117) apt-get update
118) apt-get install tor tor-geoipdb
119) </pre>

120) </p>

121) 
122) <p>
123) Now Tor is installed and running. Move on to <a href="<page

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

125) instructions.
126) </p>
127) 
128) <hr />
129) 
130) <a id="source"></a>
131) <h2><a class="anchor" href="#source">Building from source</a></h2>
132) <br />
133) 
134) <p>

135) If you want to build your own debs from source you must first add an
136) appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.
137) <pre>
138) # For the stable version.

139) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main

140) 
141) # For the unstable version.

142) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main
143) deb-src http://deb.torproject.org/torproject.org experimental-<DISTRIBUTION> main

144) </pre>
145) You also need to install the necessary packages to build your own debs and the
146) packages needed to build Tor:
147) <pre>
148) apt-get install build-essential fakeroot devscripts
149) apt-get build-dep tor
150) </pre>
151) Then you can build Tor in ~/debian-packages:
152) <pre>
153) mkdir ~/debian-packages; cd ~/debian-packages
154) apt-get source tor
155) cd tor-*
156) debuild -rfakeroot -uc -us
157) cd ..
158) </pre>
159) Now you can install the new package:
160) <pre>
161) sudo dpkg -i tor_*.deb
162) </pre>
163) </p>
164) 
165) <p>
166) Now Tor is installed and running. Move on to <a href="<page

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

168) instructions.