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.
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.
PSPDFKit Server Image Available on Amazon ECR Public Gallery
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:
services: pspdfkit: 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.
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.