Pulp’s architecture is designed to offer scalability and high availability. You can scale Pulp’s architecture in whatever way suits your needs.

With Pulp, the more you increase your availability, you also increase your capability. The more Pulpcore API processes you deploy, the more API requests you can serve. The more Pulpcore content applications you deploy, the more binary data requests you can serve. The more workers you start, the higher the tasking (syncing, publishing) throughput you deployment can handle.

You are free to, for example, deploy all of the components onto separate servers, deploy multiple Pulpcore API, content serving application, Pulpcore worker services on one server, as long as they can communicate with one another, there are no limits.


For high availability deployments, you will need to configure a clustered Postgresql and storage backend. This is mounted by default on /var/lib/pulp. This is beyond the scope of the Pulp documentation. You can also configure as many webservers as you need.

Load balancing

You can connect load balancers like HA Proxy or DNS load balancing between the webserver and the Pulpcore API and/or Pulpcore content serving applications. With load balancing, you must use the Pulp status API to ensure that all the services that you deploy are online. For a high availability deployment, consider using a load balancer in front of your webservers to help distribute client requests efficiently.

High Availability Examples

The Ansible installer documentation has example playbooks for four different deployment scenarios:

You can also use these examples as a base and further extend them to suit your needs.

In the following example, each host contains a webserver, pulpcore-api, pulpcore-content application and pulpcore-worker.

The advantages of this setup is its homogeneity. You can keep adding more hosts with the uniform setup to extend your deployment as required. Your webserver configuration never needs to change as it can always communicate with pulpcore-api, and pulpcore-content applications via localhost. However, you can configure the webserver settings in the Ansible playbooks for the Pulp installer. For this to remain highly available, ensure that the hosts are distributed across availability zones in case of a failure scenario.