Choosing a Docker Registry
PSPDFKit Processor 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 Processor images using the
pspdfkit/processor tag. For example, to pull the latest PSPDFKit Processor image, you’d run:
docker pull pspdfkit/processor:2021.2.2
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.
When using the Amazon registry, reference the Processor images using the
public.ecr.aws/pspdfkit/processor tag. For example, to pull the latest PSPDFKit Processor image, you’d run:
docker pull public.ecr.aws/pspdfkit/processor:2021.2.2
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 deploying Processor to AWS, or if you’re already using Amazon ECR to host your own images.
See the Amazon ECR pricing page for more details.