Skip to main content

devpi-server: reliable private and caching server

Project description

devpi-server: server for private package indexes and PyPI caching

PyPI cache

You can point pip or easy_install to the root/pypi/+simple/ index, serving as a transparent cache for pypi-hosted packages.

User specific indexes

Each user (which can represent a person, project or team) can have multiple indexes and upload packages and docs via standard twine or invocations. Users and indexes can be manipulated through devpi-client and a RESTful HTTP API.

Index inheritance

Each index can be configured to merge in other indexes so that it serves both its uploads and all releases from other index(es). For example, an index using root/pypi as a parent is a good place to test out a release candidate before you push it to PyPI.

Good defaults and easy deployment

Get started easily and create a permanent devpi-server deployment including pre-configured templates for nginx and process managers.

Separate tool for Packaging/Testing activities

The complementary devpi-client tool helps to manage users, indexes, logins and typical upload and installation workflows.

See on how to get started and further documentation.


If you find a bug, use the issue tracker at Github.

For general questions use the #devpi IRC channel on or the mailing list.

For support contracts and paid help contact


6.2.0 (2021-08-12)

Bug Fixes

  • Optimized some database access patterns. A new index is added to the database on first startup. For large databases that can take a while.
  • Improved performance of loads from database.
  • Optimized memory and cache use for database access.
  • Use frozenset for project name cache of mirror indexes. This mitigates memory fragmentation on some Linux distributions.

6.1.0 (2021-07-11)

Deprecations and Removals

  • Renamed ‘pypi_submit’ permission to ‘upload’. The old permission still works, but will be removed in a later major release.


  • Allow patching index with same json layout as the output of fetching json for an index.
  • Allow user and index URLs to work with a trailing slash.

Bug Fixes

  • fix #631: race condition in fetching project links from mirrors.

6.0.1 (2021-06-23)

Bug Fixes

  • fix #843: add explicit ruamel.yaml dependency declaration after strictyaml vendored it.

6.0.0 (2021-05-16)

Deprecations and Removals

  • Remove deprecated command line options which were replaced by separate scripts.
  • Dropped support for Python 2.7, 3.4 and 3.5. Python 3.x versions will be supported until their EOL (see After that, any release might break support for EOLed versions.
  • Removed deprecated --start, --stop and --status options.


  • fix #140: support force flag for deletion on non-volatile indexes.
  • fix #725: new option mirror_whitelist_inheritance for indexes. The union setting is the old behaviour and used for existing indexes to not break existing installations. With it the whitelist of each index in the inheritance order is merged into the current whitelist. This could lead to unexpected whitelisting. The new intersection setting is used for all new indexes and it intersects the whitelist at each step in the inheritance order which is more secure and never causes unexpected whitelisting.
  • fix #792: support data-yanked attribute from PEP 592 for mirror indexes.
  • fix #827: add --listen option corresponding to listen kwarg of waitress server.
  • Replicas download files asynchronously from the metadata and will do so with multiple parallel requests. This means the metadata will be in sync faster and downloads will process quicker. Missing files will be downloaded on demand if they haven’t been fetched yet. The new --file-replication-threads option allows controlling the amount of parallel downloads. Event processing waits until files for that serial are available. Since newest files are downloaded first, event processing might wait until all files are downloaded.
  • Add devpi-gen-secret script to generate a file with a random secret and proper permissions.
  • Installers will get simple results directly instead of a redirect when an index is used without /+simple or without a trailing slash.
  • Much faster mirror project names parsing. For PyPI the speedup can be about 30x.
  • Do some validity and security checks on the secret provided by --secretfile.
  • The server secret for token signing is now derived via argon2 from the data provided by --secretfile. Existing login tokens are invalidated by this.
  • Add --trusted-proxy, --trusted-proxy-count and --trusted-proxy-headers to support proxy headers with waitress.
  • The user creation and modification time is now stored. Adding or removing an index doesn’t count as a modification.

Bug Fixes

  • fix #210: the original fix was incomplete and the test for it was subtly wrong.
  • fix #451: packages not on mirror_whitelist no longer query the mirror
  • fix #680: indexes with multiple mirror bases now work correctly with default secure whitelist settings.
  • Handle cases where the Content-Type header from a mirror can be an empty string.

Other Changes

  • The X-Outside-URL header now takes precedence over the --outside-url option. This allows the option to be the fallback when there is no proxy in front, instead of overwriting the header.
  • Warning! Once you used 6.0.0 with a replica you have to check that all files have been downloaded with devpi-fsck before attempting to downgrade to 5.x.y, as those older versions have no mechanism to re-download those.
  • Add new devpiserver_auth_request hook and deprecate devpiserver_auth_user hook.
  • Require pyramid>=2.
  • Use secrets.token_bytes instead of os.urandom for salts and server secrets.
  • Replicas need to use the same secret as the master for the --secretfile option to be able to authenticate with the master.
  • Replicas will no longer proxy to the master to determine the authentication status now that the secret must be shared between master and replicas.
  • When using --restrict-modify those users can’t delete their own user object to prevent lockout.
  • The secret file must be user accessible only, devpi-server will not start if it is not.

5.5.1 (2021-03-01)

Bug Fixes

  • Pin to pyramid<2.

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for devpi-server, version 6.2.0
Filename, size File type Python version Upload date Hashes
Filename, size devpi_server-6.2.0-py3-none-any.whl (240.8 kB) File type Wheel Python version 3 Upload date Hashes View
Filename, size devpi-server-6.2.0.tar.gz (233.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page