Aspose Pdf Docker issues

Aspose.PDF Product Family
1

Docker Deployment Issues List - With aspose pdf on server

  1. ICU missing at runtime: Couldn’t find a valid ICU package installed on the system (globalization dependency for Aspose/.NET layer).
  2. libgdiplus load failure: TypeInitializationException: Gdip / DllNotFoundException: libgdiplus during PDF page-to-image conversion.
    3.Server-generated PDF output appears uniformly bold compared to local output, likely due to container font substitution/fallback and differences in font-rendering configuration.

Base image: python:3.12.10-slim-bookworm
OS family: Debian 12 (bookworm)

3

@praviney

We are checking it and will get back to you shortly.

4

@praviney The reported errors are caused by missing system dependencies in the Debian/Linux environment.
Minimal server or Docker environments do not include some libraries and fonts required by the application at runtime.
To resolve the issues, please install the following components on the server/container.

  1. ICU library (required for .NET globalization support)
    Error:
    ICU missing at runtime: Couldn’t find a valid ICU package installed on the system

Installation:
apt update
apt install -y libicu72

  1. libgdiplus (required for System.Drawing functionality)
    Error:
    libgdiplus load failure: TypeInitializationException: Gdip / DllNotFoundException

Installation:
apt install -y libgdiplus

  1. Windows fonts
    On non-Windows systems common Windows fonts are not available by default.
    Since many documents rely on them (e.g., Arial, Times New Roman, Calibri), we recommend installing Microsoft core fonts.

Installation:
apt install -y fontconfig ttf-mscorefonts-installer

If the document uses a specific or custom font that is not included in this package, it must be installed manually by copying the .ttf/.otf files to a system fonts directory (for example /usr/share/fonts/truetype/) and refreshing the font cache:

fc-cache -f -v

After installing the required dependencies, please restart the application or container.
Please try these recommendations and let us know if the issue is resolved or if you encounter any further problems.