=============================
Mirroring a PyPI repository
=============================

Before you begin
================

You need to have already completed `installing and configuring your Anaconda Server instance <install.html>`_.  Due to the size of the Anaconda repository, it is important that you have configured a file storage location with sufficient disk space.  If necessary please see the `instructions for setting the file storage location <install.html#configure-the-server>`_.

The full PyPI mirror requires approximately 120GB.

The mirror command
==================

To create a PyPI mirror run::

    binstar-sync-pypi

This will load all of the packages on pypi.python.org into the `~pypi` binstar user account.

Verify that this is working by opening your browser to http://your.anaconda.server/pypi/~pypi

Alternately, you may not wish to mirror all packages. The license_blacklist feature is not available for PyPI due to the non-standardization of license metadata for these packages. To mirror a subset of the total repository, specify which platforms you want to include, or use the whitelist or blacklist functionality to control which packages are mirrored::

    binstar-sync-pypi --mirror-config /etc/binstar/mirrors/pypi.yaml

If necessary, refer to more information on `whitelist, blacklist and license_blacklist functionality <mirrors-sync-configuration.html>`_.

Configure pip
=============

To configure pip to use this new mirror you must edit your `~/.pip/pip.conf` file::

    [global]
    index-url = http://your.anaconda.server:<port>/pypi/~pypi/simple
