Hi and thanks for writing! And thanks for being clear and comprehensive about
what you are looking for.
I'm sorry you didn't come across
https://warehouse.readthedocs.io/application/#usage-assumptions-and-concepts --
maybe we need to flag that better. As it mentions:
> Warehouse is specifically the codebase for the official Python Package Index,
> and thus focuses on architecture and features for PyPI and Test PyPI. People
> and groups who want to run their own package indexes usually use other tools,
> like devpi https://pypi.org/project/devpi-server/ .
You might also consider https://github.com/pypiserver/pypiserver or one of the
other similar projects:
https://github.com/pypiserver/pypiserver#similar-projects
I hope this helps!
(Sorry, I originally (yesterday) sent this off-list by mistake.)
--
Sumana Harihareswara
Changeset Consulting
https://changeset.nyc
On 12/20/18 9:23 AM, Christoph Bischko wrote:
> Hi all,
>
> currently, the only official warehouse documentation at
> https://warehouse.readthedocs.io seems to be quite sparse. Also it seems to
> be aimed at developers, not end users. A lot about features and the hows of
> setting up a warehouse instance is left in the dark.
>
> For instance, there is the environment file
> (https://github.com/pypa/warehouse/blob/master/dev/environment) that
> contains some very necessary settings. I did not find out about it in the
> documentation but by a painful reading of the Makefile.
> Warehouse ships with "example data". I.e. on installation there are >40k
> users and >30k dummy packages in the database by default - no instructions
> on how to remove them. Again, I read the Makefile and altered the
> example.sql database as a result.
> HTTPS seems to be disabled by default, with no documentation on how to set
> it up properly and securely.
> Account verification Mails, do not work out of the box - again no docs on
> setting that up.
> Pip installation of packages on a client via the index on my local
> Warehouse failed, because the links pointed to local host instead of the
> actual fileserver. Again, the responsible setting FILES_BACKEND in the
> environment is nowhere to be read about.
> There is no information on whether it is possible and how, to set up
> caching of the index at pypi.org with a local warehouse.
>
> As you can see, I was able to resolve some of these issues with some
> digging, reading of the code, trial and error and a bit pain. But my
> questions are:
>
> - Am I missing something here? Is warehouse not meant to be used in
> setting up your own local package index, i.e. for a company or educational
> facility?
> - Is there additional documentation I'm not aware of, something aimed at
> system administrators and end-users that want to setup their own pypi,
> because searching the web gives precious little and nothing usable?
> - Are there (maybe 3rd-party) example configurations and guides for
> warehouse?
>
> The goal for a local instance of warehouse would be:
> - Isolation of the local network from the internet (i.e. caching of pypi)
> - Speedup of package installation via local network
> - Having private packages locally that are not uploaded to pypi
>
> I hope you can help me, and maybe documenting warehouse for end users will
> get a higher priority as a result.
> Thanks,
> Christoph
>
>
>