Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

pypiserver

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • API
  • Self-hosted
7.9 Club score Visit github.com

What pypiserver is

pypiserver is a minimal, self-hosted package index for serving Python packages through tools such as pip and twine. It reads packages recursively from regular directories and supports wheels, bdists, eggs, and accompanying PGP signatures. Uploads can be sent with pip, setuptools, twine, or pypi-uploader, or copied to the server with scp. Upload access can use an Apache htpasswd file, and API users can configure custom authentication callables; the maintainers advise protecting uploads with a password. The documentation recommends placing the service behind a reverse proxy for HTTPS. It can run as a WSGI application and has documented integrations with Docker, nginx, Apache, gunicorn, and Paste. A default health endpoint returns HTTP 200 when the service is up. The project is free and open source, with Windows and Linux service instructions. The current version supports Python 3.10+ and PyPy3. Its API covers the operations needed by common packaging tools rather than the full PyPI API, and documentation uploads are accepted but not saved to disk. The server scans its package directory on each request by default, which may slow service with thousands of packages; directory caching can improve performance.

Who it suits

pypiserver suits users who want to host their own Python packages and serve them through standard packaging tools. It requires self-hosted deployment and supports Linux, macOS, and Windows.

Good to know, and what to watch

  • Serves packages from regular directories.
  • Works with pip and twine as a package index.
  • Uploads support several tools or scp.
  • Can run as a WSGI application.
  • Free and open source.
  • Implements only part of the PyPI API.
  • Documentation uploads are not saved to disk.
  • Default directory scans may slow service with thousands of packages.
  • Current version supports Python 3.10+ and PyPy3.

pypiserver

Free

Open source

Getting started

  1. Open the pypiserver GitHub project
  2. Install the current version with Python 3.10+ or PyPy3
  3. Place packages in regular directories
  4. Upload with pip, setuptools, twine, pypi-uploader, or scp
  5. Run the WSGI application with a supported server or use documented Docker options
  6. Protect uploads with authentication and place the service behind a reverse proxy for HTTPS

Limits to check

The server implements only the PyPI API needed for common package installation and search. It scans package directories on each request by default, which can slow service for thousands of packages, and accepted documentation uploads are not retained on disk.

The verdict

pypiserver provides a focused, self-hosted index for common Python package workflows. Its partial API and default per-request directory scanning are key limits to weigh as a package collection grows.

Questions people ask

Is pypiserver free?

Yes. The pypiserver plan is free at no cost and is open source.

Which platforms are supported?

It is listed for Linux, macOS, Windows, API, and self-hosted use. The current version supports Python 3.10+ and PyPy3.

How can packages be uploaded?

Uploads can use pip, setuptools, twine, or pypi-uploader, or packages can be copied with scp.

Can access be protected?

Upload protection can use an Apache htpasswd file, and API users can configure custom authentication callables.

Does it provide HTTPS?

The documentation recommends placing pypiserver behind a reverse proxy to provide HTTPS.

Does it implement the full PyPI API?

No. It implements the parts needed for easy_install, pip install, and search rather than the complete API.

What the maker publishes

API and servers
Its API returns a WSGI application that can be run with supported or user-chosen WSGI servers. source
API limit
pypiserver implements only enough of the PyPI API for easy_install, pip install, and search, rather than the full API. source
Authentication
Uploads can be protected using an Apache htpasswd file, and API users can configure custom authentication callables. source
Authentication
Uploads can be protected with Apache htpasswd authentication, and API users can configure a custom authentication callable. source
Clients
Standard Python packaging tools including pip and twine can use it as a package index. source
Deployment
The project publishes Docker images for main branch pushes and dev, alpha, beta, and final releases. source
Docker
Official Docker images are built for main pushes and development, prerelease, and final releases. source
Documentation limitation
It accepts documentation uploads but does not save them to disk. source
Health checks
It provides a default /health endpoint that returns HTTP 200 when the service is up and supports a configurable endpoint. source
HTTPS
The documentation recommends putting pypiserver behind a reverse proxy to provide HTTPS. source
Integrations
The documentation describes running pypiserver with Docker, nginx, Apache, gunicorn, Paste, and WSGI servers. source
Integrations
The documentation shows integration with pip, easy_install, setuptools, twine, Docker, and reverse proxies including Nginx and Traefik. source
Intended users
The project describes itself as a self-hosted package index for users who want to serve their own Python packages. source
License
The project’s remaining code is distributed under the zlib/libpng license, and its bundled Bottle copy is MIT-licensed. source
Limitations
It does not implement the full PyPI API and documents that it accepts documentation uploads but does not save them to disk. source
Package formats
It serves packages from regular directories and supports wheels, bdists, eggs, and accompanying PGP signatures. source
Package formats
It supports wheels, source distributions, eggs, and accompanying PGP signatures. source
Platform support
The README includes Windows service instructions using NSSM and systemd service instructions for Linux. source
Purpose
pypiserver is a minimal PyPI-compatible server for uploading and downloading Python packages with pip or easy_install. source
Purpose
pypiserver is a minimal PyPI-compatible server for uploading and downloading Python packages with pip or easy_install. source
PyPI compatibility
It implements the PyPI interfaces needed for standard packaging tools such as pip and twine to use it as a package index. source
Python support
The current version works with Python 3.10+ and PyPy3; older versions are untested and unsupported by the current series. source
Python support
The current version works with Python 3.10+ and PyPy3; older Python versions are not tested and the 1.x series is unsupported. source
Scale limit
The server scans the package directory for each incoming HTTP request by default, which can noticeably slow down service for thousands of packages; directory caching can improve performance. source

Checked against the maker's pages on 10 Oct 2026.