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 stable,

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</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) <b>Raspbian is not Debian.</b> These packages will be confusingly broken
52) for Raspbian users, since Raspbian called their architecture armhf but

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

56) </p>
57) 

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

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

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

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

64) 
65) Then add this line to your
66) <tt>/etc/apt/sources.list</tt>
67) file:<br />

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

69) deb     http://deb.torproject.org/torproject.org <DISTRIBUTION> main
70) </pre>

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

72) saucy or whatever it is)

73) in place of <DISTRIBUTION>.

74) </p>
75) 
76) <p>
77) Then add the gpg key used to sign the packages by running the following
78) commands at your command prompt:

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

80) gpg --keyserver keys.gnupg.net --recv 886DDD89
81) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
82) </pre>

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

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

86) apt-get update

87) </pre>
88) If there are no errors you're good to continue.
89) </p>
90) 
91) <p>
92) We provide a Debian package to help you keep our signing key current.  It is
93) recommended you use it.  Install it using

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

95) apt-get install deb.torproject.org-keyring
96) </pre>
97) </p>
98) 
99) <p>
100) To finally install Tor just run:

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

102) apt-get install tor

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

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

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

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

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

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

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

135) </pre>

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

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

138) <DISTRIBUTION>.

139) </p>
140) 
141) <p>
142) Then run the following commands at your command prompt:

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

144) gpg --keyserver keys.gnupg.net --recv 886DDD89
145) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
146) apt-get update

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

148) </pre>
149) </p>
150) 
151) <p>
152) Now Tor is installed and running. Move on to <a href="<page

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

154) instructions.
155) </p>
156) 
157) <hr />
158) 
159) <a id="source"></a>
160) <h2><a class="anchor" href="#source">Building from source</a></h2>
161) <br />
162) 
163) <p>
164) If you want to build your own debs from source you must first add an
165) appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.

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

167) # For the stable version.
168) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main
169) 
170) # For the unstable version.
171) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main

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

173) </pre>

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

179) packages needed to build Tor:

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

181) apt-get install build-essential fakeroot devscripts
182) apt-get build-dep tor
183) </pre>
184) Then you can build Tor in ~/debian-packages:

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

186) mkdir ~/debian-packages; cd ~/debian-packages
187) apt-get source tor
188) cd tor-*
189) debuild -rfakeroot -uc -us
190) cd ..
191) </pre>
192) Now you can install the new package:

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

194) sudo dpkg -i tor_*.deb
195) </pre>
196) </p>
197) 
198) <p>
199) Now Tor is installed and running. Move on to <a href="<page

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

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