Skip to content

Commit 6f02f97

Browse files
committed
983942-ug: Added the below details in the html to pdf trouble shooting section
1 parent 67e3c9b commit 6f02f97

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

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

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -476,6 +476,44 @@ 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 (Windows and Linux).
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 (Windows and Linux).<br>
485+
Error Message:<br>
486+
<i>“Could not find a part of the path '/home/site/wwwroot/runtimes/linux/native'”</i>
487+
</th>
488+
489+
<tr>
490+
<th style="font-size:14px" width="100px">Reason
491+
</th>
492+
<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>
493+
494+
In the <b>Azure Function Linux Flex Consumption Plan</b>, these dependencies cannot be installed due to the following limitations:
495+
496+
* No SSH access to manually install packages.<br>
497+
* Shell script installation attempts fail due to <b>permission restrictions</b>, even when permissions are explicitly set.<br>
498+
499+
As a result, the Blink-based converter cannot initialize Chromium, leading to failure in HTML-to-PDF conversion.
500+
</td>
501+
</tr>
502+
503+
<tr>
504+
<th style="font-size:14px" width="100px">Solution
505+
</th>
506+
<td>To enable HTML-to-PDF conversion using Blink in Azure Functions:<br>
507+
508+
* Do not use the Flex Consumption Plan for Linux-based Azure Functions.<br>
509+
* Instead, use one of the following:<br>
510+
1.Premium Plan<br>
511+
2.Standard Consumption Plan (Windows)<br>
512+
These plans provide the necessary environment and permissions to support Chromium and its dependencies, allowing the Blink engine to function correctly.<br>
513+
</td>
514+
</tr>
515+
</table>
516+
479517
## Unable to convert unsecured https URL to PDF using Blink
480518

481519
<table>

0 commit comments

Comments
 (0)