Skip to content

Commit cf92dd5

Browse files
Merge pull request #1520 from syncfusion-content/983942-ug
983942-ug: Added the below details in the html to pdf trouble shooting section
2 parents 67e3c9b + 0ce7a41 commit cf92dd5

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

Document-Processing/PDF/Conversions/HTML-To-PDF/NET/troubleshooting.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -476,6 +476,41 @@ Refer to this <a href="https://www.syncfusion.com/kb/10258/how-to-convert-html-t
476476
</tr>
477477
</table>
478478

479+
## HTML to PDF conversion fails after deploying to Azure Function Linux Flex Consumption Plan
480+
481+
<table>
482+
<th style="font-size:14px" width="100px">Issue
483+
</th>
484+
<th style="font-size:14px">HTML to PDF conversion fails after deploying to Azure Function Linux Flex Consumption Plan
485+
</th>
486+
<tr>
487+
<th style="font-size:14px" width="100px">Reason
488+
</th>
489+
<td>The Syncfusion HTML-to-PDF converter internally uses the <b>Blink rendering engine</b>, which relies on a <b>headless Chromium browser</b> to render HTML content. On <b>Linux environments</b>, Chromium requires several native dependencies to launch successfully.<br>
490+
491+
In the <b>Azure Function Linux Flex Consumption Plan</b>, these dependencies cannot be installed due to the following limitations:
492+
493+
* No SSH access to manually install packages.<br>
494+
* Shell script installation attempts fail due to <b>permission restrictions</b>, even when permissions are explicitly set.<br>
495+
496+
As a result, the Blink-based converter cannot initialize Chromium, leading to failure in HTML-to-PDF conversion.
497+
</td>
498+
</tr>
499+
500+
<tr>
501+
<th style="font-size:14px" width="100px">Solution
502+
</th>
503+
<td>To enable HTML-to-PDF conversion using Blink in Azure Functions:<br>
504+
505+
* Do not use the Flex Consumption Plan for Linux-based Azure Functions.<br>
506+
* Instead, use one of the following:<br>
507+
1.Premium Plan<br>
508+
2.Standard Consumption Plan<br>
509+
These plans provide the necessary environment and permissions to support Chromium and its dependencies, allowing the Blink engine to function correctly.<br>
510+
</td>
511+
</tr>
512+
</table>
513+
479514
## Unable to convert unsecured https URL to PDF using Blink
480515

481516
<table>

0 commit comments

Comments
 (0)