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) {#meta#:
7) <script type="text/javascript" src="debian-selector.js"></script>
8) :#meta#}

9) 

10) <div id="content" class="clearfix">
11)   <div id="breadcrumbs">

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

13)     <a href="<page docs/documentation>">Documentation &raquo; </a>
14)     <a href="<page docs/debian>">Debian/Ubuntu Instructions</a>
15)   </div>

16)   <div id="maincol">

17) <a id="debian"></a>

18) <h2><a class="anchor" href="#debian">Option one: Tor on Debian Stretch - stable,
19) Debian Buster - testing, or Debian Sid - unstable</a></h2>

20) <br />
21) 
22) <p>

23) If you're using Debian, just run

24) </blockquote><pre>  apt install tor </pre></blockquote>

25) as root.
26) </p>
27) 
28) <p>
29) Note that this might not always give you the latest stable Tor version, but
30) you will receive important security fixes. To make sure that you're running
31) the latest stable version of Tor, see option two below.
32) </p>
33) 
34) <p>
35) Now Tor is installed and running. Move on to <a href="<page

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

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

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

52) </p>
53) 

54) <p>
55) <b>Raspbian is not Debian.</b> These packages will be confusingly broken
56) for Raspbian users, since Raspbian called their architecture armhf but

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

60) </p>
61) 

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

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

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

66) If in doubt about your Debian version, check <a href="https://www.debian.org/releases/">the Debian website</a>.

67) For Ubuntu, ask <a href="https://en.wikipedia.org/wiki/List_of_Ubuntu_releases#Table_of_versions">Wikipedia</a>.

68) </p>
69) 
70) <div id="selector" style="display: none;">
71) <blockquote>

72) I run

73) <select id="distrib">

74) <option value="jessie">Debian oldstable (jessie)</option>
75) <option value="stretch" selected="selected">Debian stable (stretch)</option>

76) <option value="buster">Debian testing (buster)</option>

77) <option value="sid">Debian unstable (sid)</option>

78) <option value="trusty">Ubuntu Trusty Tahr (14.04 LTS)</option>
79) <option value="xenial">Ubuntu Xenial Xerus (16.04 LTS)</option>
80) <option value="artful">Ubuntu Artful Aardvark (17.10)</option>

81) </select>

82) and want

83) <select id="package"></select>

84) version

85) <select id="version"></select>

86) </blockquote>
87) 
88) 
89) <div id="apt-source">
90) <p>You need to add the following entry in <code>/etc/apt/sources.list</code> or a new file in <code>/etc/apt/sources.list.d/</code>:</p>
91) 

92) <blockquote><pre id="sources">deb https://deb.torproject.org/torproject.org jessie main

93) </pre></blockquote>
94) </div>

95) 

96) <p>Please note that the <a href="https://packages.debian.org/stretch/apt-transport-https">apt-transport-https package</a> is required to enable the usage of 'deb https://foo distro main' lines in the /etc/apt/sources.list so that all package managers using the libapt-pkg library can access metadata and packages available in sources accessible over https (Hypertext Transfer Protocol Secure).</p>

97) 

98) <div id="sig">
99) <p>Then add the gpg key used to sign the packages by running the following commands at your command prompt:</p>
100) <blockquote><pre>

101) gpg --keyserver keys.gnupg.net --recv A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89

102) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
103) </pre></blockquote>
104) </div>
105) 
106) 
107) <div id="apt-get">
108) <p>You can install it with the following commands:</p>

109) <blockquote><pre>$ apt update
110) <span id="regular-install">$ apt install <span id="apt-package">tor</span> deb.torproject.org-keyring</span>
111) <span id="source-install">$ apt install build-essential fakeroot devscripts
112) $ apt build-dep tor deb.torproject.org-keyring</span></pre></blockquote>

113) 
114) <div id="source-install2">
115) <p>
116) Then you can build Tor in ~/debian-packages:
117) </p>
118) <blockquote><pre>
119) $ mkdir ~/debian-packages; cd ~/debian-packages

120) $ apt source tor

121) $ cd tor-*
122) $ debuild -rfakeroot -uc -us
123) $ cd ..
124) </pre></blockquote>
125) <p>Now you can install the new package:</p>
126) <blockquote><pre>
127) $ sudo dpkg -i tor_*.deb
128) </pre></blockquote>
129) </div>
130) </div>
131) </div>
132) 
133) <noscript>
134) <p>

135) Then add this line to your
136) <tt>/etc/apt/sources.list</tt>
137) file:<br />

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

139) deb     http://deb.torproject.org/torproject.org <DISTRIBUTION> main
140) </pre>

141) where you put the codename of your distribution (i.e. stretch, buster, sid
142) or whatever it is)

143) in place of <DISTRIBUTION>.

144) </p>
145) 
146) <p>
147) Then add the gpg key used to sign the packages by running the following
148) commands at your command prompt:

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

150) gpg --keyserver keys.gnupg.net --recv A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89

151) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
152) </pre>

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

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

156) apt update

157) </pre>
158) If there are no errors you're good to continue.
159) </p>
160) 
161) <p>
162) We provide a Debian package to help you keep our signing key current.  It is
163) recommended you use it.  Install it using

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

165) apt install deb.torproject.org-keyring

166) </pre>
167) </p>
168) 
169) <p>
170) To finally install Tor just run:

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

172) apt install tor

173) </pre>
174) </p>
175) 

176) </noscript>
177) 

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

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

181) instructions.
182) </p>
183) 

184) <noscript>

185) <p style="font-size: small">
186) The DNS name <code>deb.torproject.org</code> is actually a set of independent
187) servers in a DNS round robin configuration.  If you for some reason cannot
188) access it you might try to use the name of one of its part instead.  Try
189) <code>deb-master.torproject.org</code>,
190) <code>mirror.netcologne.de</code> or
191) <code>tor.mirror.youam.de</code>.
192) </p>
193) 
194) <hr />
195) 
196) <a id="development"></a>
197) <h2><a class="anchor" href="#development">Option three: Using the
198) development branch of Tor on Debian or Ubuntu</a></h2>
199) <br />
200) 

201) <p>If you want to use the <a href="<page

202) download/download-unix>#packagediff">development branch</a> of Tor instead

203) (more features and more bugs), you need to add a different set of lines
204) to your <tt>/etc/apt/sources.list</tt> file:<br />

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

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

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

208) </pre>

209) where you again substitute the name of your distro (stretch, buster,
210) sid, xenial, ...) in place of

211) <DISTRIBUTION>.

212) </p>
213) 
214) <p>
215) Then run the following commands at your command prompt:

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

217) gpg --keyserver keys.gnupg.net --recv A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89

218) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -

219) apt update
220) apt install tor deb.torproject.org-keyring

221) </pre>
222) </p>
223) 
224) <p>
225) Now Tor is installed and running. Move on to <a href="<page

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

227) instructions.
228) </p>
229) 
230) <hr />
231) 
232) <a id="source"></a>
233) <h2><a class="anchor" href="#source">Building from source</a></h2>
234) <br />
235) 
236) <p>
237) If you want to build your own debs from source you must first add an
238) appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.

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

240) # For the stable version.
241) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main
242) 
243) # For the unstable version.
244) deb-src http://deb.torproject.org/torproject.org <DISTRIBUTION> main

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

246) </pre>

247) Substitute the name of your distro (stretch, buster, sid, xenial, ...) in place of <DISTRIBUTION>. Now refresh your sources by running (as root):

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

249) apt update

250) </pre>

251) You also need to install the necessary packages to build your own debs and the

252) packages needed to build Tor:

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

254) apt install build-essential fakeroot devscripts
255) apt build-dep tor

256) </pre>
257) Then you can build Tor in ~/debian-packages:

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

259) mkdir ~/debian-packages; cd ~/debian-packages

260) apt source tor

261) cd tor-*
262) debuild -rfakeroot -uc -us
263) cd ..
264) </pre>
265) Now you can install the new package:

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

267) sudo dpkg -i tor_*.deb
268) </pre>
269) </p>
270) 
271) <p>
272) Now Tor is installed and running. Move on to <a href="<page

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

274) instructions.
275) </p>

276) </noscript>

277) 
278) <!-- END MAIN COL -->

279)   </div>
280)   <div id = "sidecol">
281) #include "side.wmi"
282) #include "info.wmi"
283)   </div>
284)   <!-- END SIDECOL -->
285) </div>
286) <!-- END CONTENT -->