<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Installing Bazaar — Bazaar 2.7.0 documentation</title>
<link rel="stylesheet" href="../_static/classic.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/language_data.js"></script>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Entering commands" href="entering_commands.html" />
<link rel="prev" title="Workflows" href="bazaar_workflows.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="entering_commands.html" title="Entering commands"
accesskey="N">next</a></li>
<li class="right" >
<a href="bazaar_workflows.html" title="Workflows"
accesskey="P">previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li class="nav-item nav-item-0"><a href="../index.html">Table of Contents (2.7.0)</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Bazaar User Guide</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="installing-bazaar">
<h1>Installing Bazaar<a class="headerlink" href="#installing-bazaar" title="Permalink to this headline">¶</a></h1>
<div class="section" id="gnu-linux">
<h2>GNU/Linux<a class="headerlink" href="#gnu-linux" title="Permalink to this headline">¶</a></h2>
<p>Bazaar packages are available for most popular GNU/Linux distributions
including Ubuntu, Debian, Red Hat and Gentoo.
See <a class="reference external" href="http://wiki.bazaar.canonical.com/Download">http://wiki.bazaar.canonical.com/Download</a> for the latest instructions.</p>
</div>
<div class="section" id="windows">
<h2>Windows<a class="headerlink" href="#windows" title="Permalink to this headline">¶</a></h2>
<p>For Windows users, an installer is available that includes
the core Bazaar package together with necessary pre-requisites
and some useful plug-ins.
See <a class="reference external" href="http://wiki.bazaar.canonical.com/Download">http://wiki.bazaar.canonical.com/Download</a> for the latest instructions.</p>
<p>Note: If you are running Cygwin on Windows, a Bazaar for Cygwin package
is available and ought to be used instead of the Windows version.</p>
</div>
<div class="section" id="other-operating-systems">
<h2>Other operating systems<a class="headerlink" href="#other-operating-systems" title="Permalink to this headline">¶</a></h2>
<p>Beyond Linux and Windows, Bazaar packages are available for a large
range of other operating systems include Mac OS X, FreeBSD and Solaris.
See <a class="reference external" href="http://wiki.bazaar.canonical.com/Download">http://wiki.bazaar.canonical.com/Download</a> for the latest instructions.</p>
</div>
<div class="section" id="installing-from-scratch">
<h2>Installing from scratch<a class="headerlink" href="#installing-from-scratch" title="Permalink to this headline">¶</a></h2>
<p>If you wish to install Bazaar from scratch rather than using a
pre-built package, the steps are:</p>
<blockquote>
<div><ol class="arabic simple">
<li>If it is not installed already, install Python 2.6 or later.</li>
<li>Download the <code class="docutils literal notranslate"><span class="pre">bazaar-xxx.tar.gz</span></code> file (where xxx is the version
number) from <a class="reference external" href="http://wiki.bazaar.canonical.com/Download">http://wiki.bazaar.canonical.com/Download</a> or from Launchpad
(<a class="reference external" href="https://launchpad.net/~bzr/">https://launchpad.net/~bzr/</a>).</li>
<li>Unpack the archive using tar, WinZip or equivalent.</li>
<li>Put the created directory on your PATH.</li>
</ol>
</div></blockquote>
<p>To test the installation, try running the <strong>bzr</strong> command like this:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">version</span>
</pre></div>
</div>
<p>This will display the version of Bazaar you have installed. If this
doesn’t work, please contact us via email or IRC so we can help you
get things working.</p>
<div class="section" id="installing-into-site-wide-locations">
<h3>Installing into site-wide locations<a class="headerlink" href="#installing-into-site-wide-locations" title="Permalink to this headline">¶</a></h3>
<p>Instead of adding the directory to your PATH, you can install bzr into the
system locations using:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="n">setup</span><span class="o">.</span><span class="n">py</span> <span class="n">install</span>
</pre></div>
</div>
<p>If you do not have a compiler, or do not have the python development tools
installed, bzr supplies a (slower) pure-python implementation of all
extensions. You can install without compiling extensions with:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="n">setup</span><span class="o">.</span><span class="n">py</span> <span class="n">install</span> <span class="n">build_ext</span> <span class="o">--</span><span class="n">allow</span><span class="o">-</span><span class="n">python</span><span class="o">-</span><span class="n">fallback</span>
</pre></div>
</div>
</div>
</div>
<div class="section" id="running-the-development-version">
<h2>Running the development version<a class="headerlink" href="#running-the-development-version" title="Permalink to this headline">¶</a></h2>
<p>You may wish to always be using the very latest development version of
Bazaar. Note that this is not recommended for
the majority of users as there is an increased risk of bugs. On the other
hand, the development version is remarkably solid (thanks to the processes
we follow) and running it makes it easier for you to send us changes for
bugs and improvements. It also helps us by having more people testing
the latest software.</p>
<p>Here are the steps to follow:</p>
<blockquote>
<div><ol class="arabic">
<li><p class="first">Install Bazaar using one of the methods given above.</p>
</li>
<li><p class="first">Get a copy of the development version like this:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">branch</span> <span class="n">lp</span><span class="p">:</span><span class="n">bzr</span>
</pre></div>
</div>
</li>
<li><p class="first">Put the created directory on your PATH.</p>
</li>
</ol>
</div></blockquote>
<p>Advanced users may also wish to build the optional C extensions for greater
speed. This can be done using <code class="docutils literal notranslate"><span class="pre">make</span></code> and requires <code class="docutils literal notranslate"><span class="pre">pyrex</span></code> and a C compiler.
Please contact us on email or IRC if you need assistance with this.</p>
</div>
<div class="section" id="running-multiple-versions">
<h2>Running multiple versions<a class="headerlink" href="#running-multiple-versions" title="Permalink to this headline">¶</a></h2>
<p>It’s easy to have multiple versions of Bazaar installed and to switch
between them. To do this,
simply provide the full pathname to the <strong>bzr</strong> command you wish to run.
The relevant libraries will be automatically detected and used. Of course,
if you do not provide a pathname, then the <strong>bzr</strong> used will be the one
found on your system path as normal.</p>
<p>Note that this capability is particularly useful if you wish to run
(or test) both the latest released version and the development version say.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Installing Bazaar</a><ul>
<li><a class="reference internal" href="#gnu-linux">GNU/Linux</a></li>
<li><a class="reference internal" href="#windows">Windows</a></li>
<li><a class="reference internal" href="#other-operating-systems">Other operating systems</a></li>
<li><a class="reference internal" href="#installing-from-scratch">Installing from scratch</a><ul>
<li><a class="reference internal" href="#installing-into-site-wide-locations">Installing into site-wide locations</a></li>
</ul>
</li>
<li><a class="reference internal" href="#running-the-development-version">Running the development version</a></li>
<li><a class="reference internal" href="#running-multiple-versions">Running multiple versions</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="bazaar_workflows.html"
title="previous chapter">Workflows</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="entering_commands.html"
title="next chapter">Entering commands</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-guide/installing_bazaar.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="entering_commands.html" title="Entering commands"
>next</a></li>
<li class="right" >
<a href="bazaar_workflows.html" title="Workflows"
>previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li class="nav-item nav-item-0"><a href="../index.html">Table of Contents (2.7.0)</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >Bazaar User Guide</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2009-2011 Canonical Ltd.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.8.4.
</div>
</body>
</html>
