tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 3-low
4) 

5) #include "head.wmi" TITLE="Tor: Debian/Ubuntu Instructions" CHARSET="UTF-8"

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) as root.

21) </p>
22) 

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

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

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

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

40) Debian</a></h2>

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

52) you're using Ubuntu 10.04 it's "lucid", 9.10 is  "karmic", 9.04 is "jaunty",

53) 8.10 is "intrepid", and 8.04 is "hardy". If you're using Debian
54) Etch, it's "etch", and Debian Lenny is "lenny". Then add this line to your

55) <tt>/etc/apt/sources.list</tt>

56) file:<br />

57) <pre>

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

59) </pre>

60) where you put the codename of your distribution (i.e. etch, lenny, sid,
61) lucid, karmic,

62) jaunty, intrepid, hardy or whatever it is) in place of <DISTRIBUTION>.

63) </p>
64) 

65) <p>

66) Then add the gpg key used to sign the packages by running the following
67) commands at your command prompt:

68) <pre>

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

71) </pre>

72) Now refresh your sources and install Tor by running the following
73) commands at your command prompt:

74) <pre>

75) apt-get update
76) apt-get install tor tor-geoipdb
77) </pre>

78) </p>

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

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

83) instructions.
84) </p>
85) 

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

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

107) deb     http://deb.torproject.org/torproject.org <DISTRIBUTION> main
108) deb     http://deb.torproject.org/torproject.org experimental-<DISTRIBUTION> main

109) </pre>

110) where you again substitute the name of your distro (etch, lenny, sid,
111) lucid, karmic,

112) jaunty, intrepid, hardy) in place of <DISTRIBUTION>.

113) </p>
114) 
115) <p>

116) Then run the following commands at your command prompt:

117) <pre>

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

120) apt-get update
121) apt-get install tor tor-geoipdb
122) </pre>

123) </p>

124) 
125) <p>
126) Now Tor is installed and running. Move on to <a href="<page

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

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

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

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

143) 
144) # For the unstable version.

145) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main
146) deb-src http://deb.torproject.org/torproject.org experimental-<DISTRIBUTION> main

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

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

171) instructions.