Choose a Docker Registry

Information

PSPDFKit Server has been deprecated and replaced by PSPDFKit Document Engine. All PSPDFKit Server and PSPDFKit for Web Server-Backed licenses will work as before and be supported until 15 May 2024 (we will contact you about license migration). To start using Document Engine, refer to the migration guide. With Document Engine, you’ll have access to robust new capabilities (read the blog for more information).

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.

Docker Hub

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:2024.1.2

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 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:2024.1.2

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 , or if you’re already using Amazon ECR to host your own images.

See the Amazon ECR pricing page for more details.