Choosing 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.

Docker Hub

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.1.1

Rate Limits

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 docker pull:

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.1.1

Rate Limits

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.