Getting started

Pulp 3 Ansible installer is a collection of roles to install or upgrade Pulp 3 hosted on galaxy:

Some plugins may require a prereq role, if so, you can find the prereq roles under pulp user here:


The collection requires geerlingguy.postgresql role, which should be installed from ansible-galaxy.

ansible-galaxy install geerlingguy.postgresql

NOTE: Some plugins may require a prereq role, which is the case of pulp_rpm:

ansible-galaxy install pulp.pulp_rpm_prerequisites


The recommended installation is from ansible-galaxy:

ansible-galaxy collection install pulp.pulp_installer

Using the example playbook

Some of the roles used in the playbook use root privileges on the managed node, so when prompted, you will need to provide the password for the managed node user.

ansible-playbook playbooks/example-use/playbook.yml -u <managed_node_username> --ask-become-pass

To configure a custom install, you will need to set configuration variables. In the simplest case, they can be set in the playbook. See the ansible docs for more flexible idiomatic alternatives.

My first playbook

As an example, we are going to write a playbook for installing pulp_container and pulp_rpm. You can learn more about the variables on the roles section

1 - Installing pulp_installer collection:

ansible-galaxy collection install pulp.pulp_installer

2 - Installing geerlingguy.postgresql role:

ansible-galaxy install geerlingguy.postgresql

3 - Writing the playbook (Example of playbook below):

vim install.yml

- hosts: all
      secret_key: << YOUR SECRET HERE >>
      content_origin: "http://{{ ansible_fqdn }}"
    pulp_default_admin_password: << YOUR PASSWORD HERE >>
      # galaxy-ng: {}
      # pulp-ansible: {}
      # pulp-certguard: {}
      pulp-container: {}
      # pulp-cookbook: {}
      # pulp-deb: {}
      # pulp-file: {}
      # pulp-gem: {}
      # pulp-maven: {}
      # pulp-npm: {}
      # pulp-python: {}
        prereq_role: "pulp.pulp_rpm_prerequisites" # RPM plugin needs a prereq_role:
      - pulp.pulp_installer.pulp_database
      - pulp.pulp_installer.pulp_workers
      - pulp.pulp_installer.pulp_resource_manager
      - pulp.pulp_installer.pulp_webserver
      - pulp.pulp_installer.pulp_content
4 - Installing pulp_rpm prereq role:
ansible-galaxy install pulp.pulp_rpm_prerequisites
5 - Running the playbook:
ansible-playbook install.yml -u <managed_node_username> --ask-become-pass