diff --git a/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/troubleshooting.md b/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/troubleshooting.md index 41f8e0e98..480910a21 100644 --- a/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/troubleshooting.md +++ b/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/troubleshooting.md @@ -476,6 +476,41 @@ Refer to this Issue + +HTML to PDF conversion fails after deploying to Azure Function Linux Flex Consumption Plan + + +Reason + +The Syncfusion HTML-to-PDF converter internally uses the Blink rendering engine, which relies on a headless Chromium browser to render HTML content. On Linux environments, Chromium requires several native dependencies to launch successfully.
+ +In the Azure Function Linux Flex Consumption Plan, these dependencies cannot be installed due to the following limitations: + +* No SSH access to manually install packages.
+* Shell script installation attempts fail due to permission restrictions, even when permissions are explicitly set.
+ +As a result, the Blink-based converter cannot initialize Chromium, leading to failure in HTML-to-PDF conversion. + + + + +Solution + +To enable HTML-to-PDF conversion using Blink in Azure Functions:
+ +* Do not use the Flex Consumption Plan for Linux-based Azure Functions.
+* Instead, use one of the following:
+1.Premium Plan
+2.Standard Consumption Plan
+These plans provide the necessary environment and permissions to support Chromium and its dependencies, allowing the Blink engine to function correctly.
+ + + + ## Unable to convert unsecured https URL to PDF using Blink