docs/en/rpms.wml (0b913ba4b) - tor-webwml.git

rpms.wml

## translation metadata
# Revision: $Revision$
# Translation-Priority: 3-low

#include "head.wmi" TITLE="Tor Project: CentOS/Fedora/OpenSUSE Instructions" CHARSET="UTF-8"
<div id="content" class="clearfix">
  <div id="breadcrumbs">
    <a href="<page index>">Home &raquo; </a>
    <a href="<page docs/documentation>">Documentation &raquo; </a>
    <a href="<page docs/rpms>">RPMs</a>
  </div>
  <div id="maincol"> 
    <a id="rpms"></a>
    <h2><a class="anchor" href="#rpms">Tor packages for RPM-based
    linux distributions.</a></h2>
    <br>
    
    <p><strong>Do not</strong> use the packages in the native repositories. They are
    frequently out of date. That means you'll be missing stability and
    security fixes.
    </p>
    
    <p>
    You'll need to set up our package repository before you can fetch
    Tor. Repositories contain i686 and x86_64 builds. Assuming yum, in
    /etc/yum.repos.d/, create a file called
    torproject.repo.  Edit this file with the following information:
    </p>

<h3>Fedora 19/20 and EL6/7 packages</h3>

<p>For Fedora 19, Fedora 20, RHEL 6, RHEL 7 (and clones), use following
    repo file - substitute DISTRIBUTION with one of the following: fc/19, fc/20,
    el/6, el/7 according to your distribution.
    </p>
    
<pre>[tor]
name=Tor repo
enabled=1
baseurl=http://deb.torproject.org/torproject.org/rpm/DISTRIBUTION/$basearch/
gpgcheck=1
gpgkey=http://deb.torproject.org/torproject.org/rpm/RPM-GPG-KEY-torproject.org.asc

[tor-source]
name=Tor source repo
enabled=1
autorefresh=0
baseurl=http://deb.torproject.org/torproject.org/rpm/DISTRIBUTION/SRPMS
gpgcheck=1
gpgkey=http://deb.torproject.org/torproject.org/rpm/RPM-GPG-KEY-torproject.org.asc
</pre>
    <p>
    The keys's fingerprint should be (for RPM-GPG-KEY-torproject.org.asc above,
    yum will ask about the fingerprint):
    </p>
<pre>3B9E EEB9 7B1E 827B CF0A  0D96 8AF5 653C 5AC0 01F1</pre>

<h3>Name clash warning</h3>

<p>There is identically named 'tor' package in the EPEL and Fedora
    repositories. Due to this unfortunate name clash, the packages might
    "update over one another", depending on patchversion.  Solution is to use
    <tt>Exclude=tor</tt> line in the relevant <tt>/etc/yum.repos.d/</tt>
    file.
    </p> 
    
    <p>E.g. you may exclude EPEL's Tor package by putting the mentioned exclude
    line under [epel] section in <tt>/etc/yum.repos.d/epel.repo</tt>.
    </p>
    
    <h3>Package installation and running</h3>

<p>
    Once you have the repo file, install Tor using (yum will ask about the
    key's fingerprint the first time):
    </p>
<pre>yum install tor</pre>
    
    <p>
    Start Tor using:
    </p>
<pre>service tor start</pre>
    
    <p>
    Now Tor is installed and running. Move on to <a href="<page
    docs/tor-doc-unix>#using">step two</a> of the "Tor on Linux/Unix"
    instructions.
    </p>
    
    <p style="font-size: small">
    The DNS name <code>deb.torproject.org</code> is actually a set of independent
    servers in a DNS round-robin configuration.  If for some reason you cannot
    use it, you might be able to access one of the individual servers
    instead.  Try
    <code>deb-master.torproject.org</code>,
    <code>mirror.netcologne.de</code> or
    <code>tor.mirror.youam.de</code>.
    </p>
    
    <hr>
    
    <hr>
    
    <h2>Alpha/development packages</a></h2>
    <br>
    
    <p>
    There is a repository that contains packages for latest alpha branch of Tor.
    If you'd like to experiment with them, use one of the above repo files, just
    change the baseurl to (similarly to previous section, substitute
    DISTRIBUTION based on your distribution; for source rpms use "SRPMS" instead
    of $basearch):
    </p>
<pre>baseurl=http://deb.torproject.org/torproject.org/rpm/tor-testing/DISTRIBUTION/$basearch/</pre>
    
    <a id="source"></a>
    <h2><a class="anchor" href="#source">Building from source</a></h2>
    <br>
    
    <p>
    If you'd like to build from source, please follow the <a
    href="<gitblob>doc/contrib/tor-rpm-creation.txt">RPM creation instructions</a>.
    </p>
    
    <hr>
    
    <p>If you have suggestions for improving this document, please <a
    href="<page about/contact>">send them to us</a>. Thanks!</p>
  </div>
  
  <div id = "sidecol">
#include "side.wmi"
#include "info.wmi"
  </div>
  
</div>

#include <foot.wmi>

tor-webwml.git

update to rpm instructions from ondrej (bug 12734)