Index Configuration

Downloading / Installing packages from the index


The mypi index-urls all begin with /simple

pip config file

The pip config file is locate in ~/.pip/pip.conf (See the pip docs for more details).


timeout = 60
extra-index-url = http://path/to/your/mypi/install/simple


Using extra-index-url adds a URL to the search. Using index-url will replace the search list!

pip command-line

With pip you can specify an index URL directly on the command line:

pip install --extra-index-url http://path/to/your/index/simple yourpackage

or, if you want to completely override pypi:

pip install -i http://path/to/your/index/simple yourpackage

Parsing requirements (pip)

It’s also possible to define your index-urls for package requirements. You can either use the setuptools option inside

    dependency_links = ["http://path/to/mypi/simple/<yourpackage>"],

or, you can add the index-url/extra-index-url to your requirements.txt file. See the pip requirements page for more info.


easy_install is “the old way” of installing packages. It also allows you to specify and index-url. See the easy_install docs for more info.

Uploading packages to your index

To upload packages to pypi, you first need to register your package:

python register

Next you can upload files to the index:

python sdist upload # uploads a source distribution

In order to upload to your private index, you first need to edit ~/.pypirc to define your index. Here’s an example:

index-servers =

repository: http://pyrepo:8080

repository: http://pyrepo/mypi

Then you can upload like so:

python register -r myindex
python sdist upload -r myindex