Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install localshop

How to install localshop

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install localshop
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
0.4.1Never BuiltWhy not?
0.2.2 Available View build log
0.2 Available View build log
0.1.1 Available View build log
Linux (32-bit)
0.4.1Never BuiltWhy not?
0.4.0 Available View build log
0.2.2 Available View build log
0.2 Available View build log
0.1.1 Available View build log
Linux (64-bit)
0.4.1 Available View build log
0.2.2 Available View build log
0.2 Available View build log
0.1.1 Available View build log
Lastest release
version 0.4.1 on Jan 9th, 2014



A pypi server which automatically proxies and mirrors pypi packages based

upon packages requested. It also supports the uploading of local (private)


Getting started

Download and install localshop via the following command:

pip install localshop

This should best be done in a new virtualenv. Now initialize your localshop

environment by issuing the following command:

localshop init

If you are upgrading from an earlier version simply run:

localshop upgrade

And then start it via:

localshop run_gunicorn

localshop celeryd -B -E

Celeryd is required to do the mirroring of the pypi packages once they

are needed.

You can also start it via honcho using the Procfile:

pip install -r honcho

honcho start

You can now visit http://localhost:8000/ and view all the packages in your


The next step is to give access to various hosts to use the shop. This

is done via the webinterface (menu -> permissions -> cidr). Each ip

address listed there will be able to download and upload packages.

How it works

Packages which are requested and are unknown are looked up on pypi via the

xmlrpc interface. At the moment the client downloads one of the files which

is not yet mirror'ed a 302 redirect is issued to the correct file (on pypi).

At that point the worker starts downloading the package and stores it in

~/.localshop/files so that the next time the package is request it is

available within your own shop!

Uploading local/private packages

To upload your own packages to your shop you need to modify/create a .pypirc

file. See the following example:


index-servers =



username: myusername

password: mysecret

repository: http://localhost:8900/simple/

To upload a custom package issue the following command in your package:

python setup.py upload -r local

It should now be available via the webinterace

Using the shop for package installation

To install packages with pip from your localshop add -i flag, e.g.:

pip install -i http://localhost:8900/simple/ localshop

Credentials for authentication

If you don't want to use your Django username/password to authenticate

uploads and downloads you can easily create one of the random credentials

localshop can create for you.

Go to the Credentials section and click on create. Use the access key

as the username and the secret key as the password when uloading packages.

A .pypirc could look like this:


index-servers =



username: 4baf221849c84a20b77a6f2d539c3e8a

password: 200984e70f0c463b994388c4da26ec3f

repository: http://localhost:8900/simple/

pip allows you do use those values in the index URL during download, e.g.:

pip install -i http://<access_key>:<secret_key>@localhost:8900/simple/ localshop

So for example:

pip install -i http://4baf221849c84a20b77a6f2d539c3e8a:200984e70f0c463b994388c4da26ec3f@localhost:8900/simple/ localshop


Please be aware that those credentials are transmitted unencrypted over

http unless you setup your localshop instance to run on a server that

serves pages via https.

In case you ever think a credential has been compromised you can disable it

or delete it on the credential page.


There are a few settings to set in ~/.localshop/localshop.conf.py that

change the behaviour of the localshop.



If set to True files will be cleaned up after deleting a package or

release from the localshop.



The dotted import path of a Django storage class to be used when uploading

a release file or retrieving it from PyPI.

Subscribe to package updates

Last updated Jan 9th, 2014

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.