2021.3 Migration Guide

This release removes the deprecated local asset storage backend and brings many improvements, including support for ARM processors.

Removal of the Local Asset Storage Backend

This version officially removes the local asset storage backend. Note that if you’re still using the local asset storage backend, you won’t be able to use this version to migrate away from it. To upgrade, migrate to another storage backend by following the migration guide for the Server version you use. Once you’ve moved to the new backend, you can start using Server 2021.3.

ARM Support

Starting with this version, we now support running on ARM64-based processors such as AWS Graviton. PSPDFKit Server on ARM provides all the same features as its x86_64 counterpart. To get started, follow our usual deployment guides on any ARM64-compatible machine that supports Docker.

Starting with this version, PSPDFKit Server images are available on Amazon ECR Public Gallery as an alternative to Docker Hub. To use the new registry, use public.ecr.aws/pspdfkit/pspdfkit instead of pspdfkit/pspdfkit when referring to the PSPDFKit Server image.

For example, if you use Docker Compose, do the following:

image: public.ecr.aws/pspdfkit/pspdfkit:2021.3

Check out our guide to learn which of the registries better suits your needs.

S3 Configuration Improvements

We revised the Server’s S3 configuration resolution system, which greatly simplifies the use of the S3 storage backend when you’re running on AWS. Server can now use the credentials provided by the ECS Task Role or the EC2 Instance Role, which means that you don’t need to explicitly configure S3 access keys if you’ve attached these roles to your infrastructure. To learn more, check out our documentation on the S3 asset storage backend.

Other Changes

This release includes many more improvements. For a full list of changes, check out the Server changelog.

Migrate PSPDFKit for Web

For more information, please take a look at the PSPDFKit for Web 2021.3 Migration Guide.