--- title: "Upgrading from PSPDFKit Server" canonical_url: "https://www.nutrient.io/guides/document-engine/release-notes/upgrading-from-server/" md_url: "https://www.nutrient.io/guides/document-engine/release-notes/upgrading-from-server.md" last_updated: "2026-05-23T00:08:18.047Z" description: "Migrate your PSPDFKit Server to Document Engine by updating your Docker image and adapting to new licensing. Ensure a smooth transition with these essential steps." --- # Upgrading from PSPDFKit Server [PSPDFKit Server](https://www.nutrient.io/guides/product-archives-and-deprecated-solutions.md) no longer receives updates as of version 2024.1.2 and has been replaced by [Document Engine](https://www.nutrient.io/guides/document-engine.md). This guide will walk you through the necessary steps to migrate your existing Server instance to Document Engine. ## Before the upgrade Ensure you’re running the latest version of Server (2024.1.2) before migrating to Document Engine. To upgrade, follow PSPDFKit Server’s [migration guides](https://www.nutrient.io/guides/web/release-notes/upgrading.md#pspdfkit-server). If you haven’t done so yet, now is a good time to carefully read our [overview of the upgrade process](https://www.nutrient.io/guides/document-engine/release-notes/upgrading.md). ## Updating the Docker image To upgrade to Document Engine, you’ll need to change Server’s Docker image from `pspdfkit/pspdfkit` to `pspdfkit/document-engine`. Use the following image for the Document Engine version 1.15.0: ```sh pspdfkit/document-engine:1.15.0 ``` We publish our images to DockerHub and AWS ECR. Refer to our [Docker registries](https://www.nutrient.io/guides/document-engine/deployment/docker-registry.md) guide to learn more. Always use a specific image version tag; never rely on `:latest`. ## License changes Document Engine uses a new license format that streamlines licensing. Refer to our [licensing](https://www.nutrient.io/guides/document-engine/about/licensing.md) guide to learn more about Document Engine licensing. No migration is necessary for your license at this point. Existing Server licenses will continue to work just like before, and you can continue using them with Document Engine without any problems. Once your license is migrated, you’ll receive additional information about the license update. We plan to drop support for legacy licenses in Document Engine builds produced after 15 May 2024. ## Configuration changes No migration is necessary. Your existing [configuration](https://www.nutrient.io/guides/document-engine/configuration/options.md) options will continue working in Document Engine without any changes. ## API changes No migration is necessary. The Document Engine [API](https://www.nutrient.io/api/reference/document-engine/upstream/) is 100 percent compatible with the PSPDFKit Server API. ## Metrics The [metrics tag](https://www.nutrient.io/guides/document-engine/monitoring/metrics-reference.md#tags) `family` will change from `pspdfkit-server` to `pspdfkit-document-engine`. If you’re using [metrics](https://www.nutrient.io/guides/document-engine/monitoring/metrics-reference.md), make sure to update your queries to reflect the new value. ## Changes to Web Server-Backed There are important changes to Nutrient Web SDK integration with Document Engine that you should be aware of. ### No matching versions with Nutrient Web SDK PSPDFKit Server and Nutrient Web SDK historically required matching versions to work together. This requirement has been dropped in PSPDFKit Server (and Nutrient Web SDK) version [2024.1.0](https://www.nutrient.io/guides/product-archives-and-deprecated-solutions.md). With the introduction of Document Engine, we’re extending this concept even further: Document Engine will no longer require a matching version of Nutrient Web SDK. Both products will have separate release cycles and versions. Document Engine maintains a [minimal version](https://www.nutrient.io/guides/document-engine/about/requirements.md#pspdfkit-for-web-version-requirements) of Nutrient Web SDK that’s fully supported. If the version requirement isn’t met, Document Engine will refuse to connect to the Nutrient Web SDK client. This allows you to update the Document Engine to a newer version without influencing your frontend, as was necessary with PSPDFKit Server. Document Engine also maintains a maximum recommended version of Nutrient Web SDK that’s known to be fully working with a particular Document Engine version. This version is used for the version of Nutrient Web SDK integrated in the documents view in the [Document Engine dashboard](https://www.nutrient.io/guides/document-engine/management/dashboard.md) and served as `/pspdfkit.js`. Nutrient Web SDK maintains a minimal version of Document Engine that’s required to fully support its features. If the version requirement isn’t met, Nutrient Web SDK will refuse to connect to Document Engine. To streamline the support process, always specify both Nutrient Web SDK and Document Engine versions in your support requests. ### Serving Nutrient Web SDK PSPDFKit Server historically shipped with a matching version of the Web SDK. This is no longer true since [2024.1.0](https://www.nutrient.io/guides/product-archives-and-deprecated-solutions.md). Some of our customers reported problems with this change. We listened and are now providing a CDN with the Web SDK bundles that can be used to simplify the setup. Refer to our [guide](https://www.nutrient.io/guides/document-engine/viewer/client-integration/web.md) on integrating the Web SDK with Document Engine for more details. --- ## Related pages - [1 10](/guides/document-engine/release-notes/1-10.md) - [1 1](/guides/document-engine/release-notes/1-1.md) - [1 13](/guides/document-engine/release-notes/1-13.md) - [1 12](/guides/document-engine/release-notes/1-12.md) - [1 14](/guides/document-engine/release-notes/1-14.md) - [1 11](/guides/document-engine/release-notes/1-11.md) - [1 2](/guides/document-engine/release-notes/1-2.md) - [1 15](/guides/document-engine/release-notes/1-15.md) - [1 4](/guides/document-engine/release-notes/1-4.md) - [1 5](/guides/document-engine/release-notes/1-5.md) - [1 3](/guides/document-engine/release-notes/1-3.md) - [1 9](/guides/document-engine/release-notes/1-9.md) - [1 7](/guides/document-engine/release-notes/1-7.md) - [Upgrading from PSPDFKit Processor](/guides/document-engine/release-notes/upgrading-from-processor.md) - [1 8](/guides/document-engine/release-notes/1-8.md) - [1 6](/guides/document-engine/release-notes/1-6.md) - [Upgrading Document Engine](/guides/document-engine/release-notes/upgrading.md)