Installation & Configuration


PyPPi is a self-contained Django project as a pluggable application.

Run integrated server

The most simple way to install PyPPi is by:

# Make sure we run with Bash, create a virtualenv and install packages
$ bash
$ virtualenv pyppi-site
$ source pyppi-site/bin/activate
$ pip install pyppi

# Initialize our installation
$ pyppi init
# Run the server
$ pyppi start

That’s it, we’re now ready to surf to http://localhost:8000/ .


By default PyPPi installs and runs from ~/.pippy where the default configuration file is created

You can use a different config file by setting the PYPPI_CONF environment variable or passing --config to pyppi. This must point to a valid Django settings file.

For advanced configuration please check Settings


For a permanent setup, simply create a supervisor configuration (you can omit the environment setting if you didn’t specify a different project root):

user = www-data
directory = /path/to/virtualenv
command = /path/to/virtualenv/bin/pyppi start -D
environment = PYPPI_CONF='/path/to/'

Table Of Contents

Previous topic


Next topic

Developers: How to upload packages

This Page