Choose a Docker Registry
PSPDFKit Server images are available in two alternative Docker registries: Docker Hub and Amazon ECR Public Gallery. Images hosted in both registries are exactly the same. Which registry to choose will depend on your image pull frequency and deployment infrastructure.
When using Docker Hub, reference the Server images using the
pspdfkit/pspdfkit tag. For example, to pull the latest PSPDFKit Server image, you’d run:
docker pull pspdfkit/pspdfkit:2023.1.4
On 1 November 2020, Docker began imposing a limit on the number of image pulls from Docker Hub available for non-paid accounts:
100 pulls per 6 hours for non-authenticated users
200 pulls per 6 hours for authenticated users
Note that the limits don’t apply to paid accounts. You can find the details on Docker’s pricing page.
You’ll know that you reached the limit when you see the following error when running
You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limits.
If you find yourself hitting the limit frequently, we recommend either signing up for a paid Docker plan, or using the images from Amazon ECR Public Gallery.
Amazon ECR Public Gallery
When using the Amazon registry, reference the Server images using the
public.ecr.aws/pspdfkit/pspdfkit tag. For example, to pull the latest PSPDFKit Server image, you’d run:
docker pull public.ecr.aws/pspdfkit/pspdfkit:2023.1.4
The following pull image limits apply when using the Amazon registry:
500 GB of image data per month for non-authenticated users
5 TB of image data per month for authenticated users when pulling from non-AWS managed infrastructure
Unlimited data transfer when pulling from AWS infrastructure
The Amazon registry is a great choice if you’re , or if you’re already using Amazon ECR to host your own images.
See the Amazon ECR pricing page for more details.