If you’re a new user and are unsure where to begin, this page outlines the different options available, as well as limitations and requirements for those options. Each sections has links to corresponding documentation for each installation method. If you’ve any questions or feedback about installing Pulp, we would love to hear from you on our Pulp Community Discourse.

Want to evaluate Pulp?

The quickest way to evaluate Pulp is by using Pulp in One Container. This image contains all the services that you need to run Pulp and is perfect for an initial evaluation. Mind that this container cannot scale to provide for high availability scenarios.

For installation instructions, see Pulp in One Container.

Is there a manual installation option available?

You can manually install Pulp using pip or from source.

For pip installation instructions, see PyPI installation.

Is there a Kubernetes/OpenShift deployment option?

Pulp operator endeavours to provide a scalable and robust cluster for Pulp 3. Pulp can be installed from OperatorHub. If you’re interested in providing feedback or contributing to making this better, see the Pulp operator repo on GitHub. For more information about using Pulp operator, see Pulp on Openshift

Is there a podman compose deployment option?

Based on community feedback from the survey and PulpCon 2021, we have reused the Pulp operator images to create a podman compose option for deploying Pulp. If you’re familiar with podman compose, you can customize the configuration to suit your deployment needs and to deploy at scale. If you do use it, let us know your feedback. For more information see our podman compose page.

Is there a docker compose deployment option?

Kong maintain a Docker compose option for deploying Pulp. They have diligently documented known issues and the Pulpcore version in the compose is generally one release behind the latest Pulpcore release. For more information, see Kong’s Github repo.

Do you need something else?

If you are blocked and don’t find an option that you need, please post to our Pulp Community Discourse and let us know what problem you encountered or what scenario you’re missing. Feel free to introduce yourself, what you’re trying to achieve, where you ran into problems or didn’t understand something. We’re always happy to hear how people are using Pulp!

You can also find us on pulp on Matrix for user support.

Project history

Moving from Pulp 2 to Pulp 3, the Pulp community decided to stop with RPM-based installations in favour of the Ansible installer. If you’re interested in understanding the motivations for such a change, see What motivated Pulp to change the primary installation method?. The Pulp project has decided to deprecate Ansible installer in favour of containerized installations, see the motivations here