Installing Pulp 3 and getting all the services running can be challenging. To reduce the complexity of getting started with Pulp, the Pulp team created a single container image that has all necessary services to run Pulp 3.
The image is available under the
pulp namespace on Dockerhub. This image includes the Ansible, Container, File, Maven, Python, and RPM plugins. A new version is published every time there is a plugin update available. You can update your environment to the latest version of the container using
If you experience any problems, check the Known Issues section for workarounds. If you have any questions, feel free to reach out to us on
firstname.lastname@example.org or the
#pulp channel on Freenode IRC.
You can use either
docker. If you use
podman in the following examples.
The following commands can be used to start Pulp 3.4.1 with
podman 1.8.0, which is available on Fedora 31.
$ mkdir settings pulp_storage pgsql containers $ echo "CONTENT_ORIGIN='http://$(hostname):8080' ANSIBLE_API_HOSTNAME='http://$(hostname):8080' ANSIBLE_CONTENT_HOSTNAME='http://$(hostname):8080/pulp/content' TOKEN_AUTH_DISABLED=True" >> settings/settings.py
For systems with SELinux in enforcing mode, use the following command to start Pulp:
$ podman run --detach \ --publish 8080:80 \ --name pulp \ --volume ./settings:/etc/pulp:Z \ --volume ./pulp_storage:/var/lib/pulp:Z \ --volume ./pgsql:/var/lib/pgsql:Z \ --volume ./containers:/var/lib/containers:Z \ --device /dev/fuse \ pulp/pulp
For systems without SELinux in enforcing mode, use the following command to start Pulp:
$ podman run --detach \ --publish 8080:80 \ --name pulp \ --volume ./settings:/etc/pulp \ --volume ./pulp_storage:/var/lib/pulp \ --volume ./pgsql:/var/lib/pgsql \ --volume ./containers:/var/lib/containers \ --device /dev/fuse \ pulp/pulp
In both cases, you will see the following output. The last line contains the container ID that you can use to execute commands inside the container.
Trying to pull docker.io/pulp/pulp... Getting image source signatures Copying blob 67e3038dc3b7 done Copying blob ff23023c8c8d done Copying blob 8c32f98c5416 done Copying blob f328d15d69fa done Copying blob ffcb1be59aa1 done Copying blob b9a1b34b38d0 done Copying blob 443cb276d4ae done Copying blob d4bcf1091bc0 done Copying blob f8e0ce13e5f4 done Copying blob 0c976302c80e done Copying blob d69fddf60189 done Copying blob dba42db3b9a9 done Copying blob 63e0efa76d65 done Copying blob 355e3ca36a59 done Copying blob 9854ce01af4c done Copying blob d2e7008e82d0 done Copying blob 7d16b80a34a6 done Copying blob 219dcbdc1826 done Copying blob 62370638e9ec done Copying blob 01ceabebb047 done Copying blob a1881de732d0 done Copying blob 0e76fdd96f40 done Copying blob 673f8ea740ee done Copying blob bfce4aba4f42 done Copying blob eb6e7e68f0d6 done Copying blob 0f6b1bb45cd3 done Copying config 2692cc3736 done Writing manifest to image destination Storing signatures f7044dec1e9d1b9dd66d44e0056280a4399d6eac5c258f03a3a8ccd2a7e6effc
Note that the container ID is unique to your deployment.
Use the container ID to reset the
admin user’s password.
podman also accepts the first part
of the ID for convenience.
$ podman exec -it pulp bash -c 'pulpcore-manager reset-admin-password' Please enter new password for user "admin": Please enter new password for user "admin" again: Successfully set password for "admin" user.
At this point, both the REST API and the content app are available on your host’s port
The Container file and all other assets used to build the container image are available on GitHub.
Any known issues and workarounds are listed here.
Docker on CentOS 7
While using the version of Docker that is provided with CentOS 7, there is a known issue that will cause the following error to occur:
FATAL: could not create lock file "/var/run/postgresql/.s.PGSQL.5432.lock": No such file or directory
The version of Docker that is provided with CentOS 7 mounts
/run. The Pulp Container recipe uses
/var/run, which is a symlink to
/run, and expects its contents to be available at container run time. This lack of availability causes the quick fail.
You can work around this by specifying an additional
/run volume, which suppresses this behavior of the Docker run time. Docker will copy the image’s contents to that volume and the container will start as expected.
pulp/pulp-fedora31 container vendored PostgreSQL 11. The
pulp/pulp image vendors PostgreSQL 12. Users wishing to migrate from PostgreSQL 11 to 12 should refer to PostgreSQL documentation.