# Resolución de errores libcef.dll en IronPDF
¿Está viendo los siguientes mensajes de error?
- Error al cargar uno de los ensamblajes de Chrome (libcef.dll)
- Fallo en la implementación de Chrome (error al cargar libcef.dll) (203)
Esto se debe a que `System.Drawing` no está incluido en Windows Nano Server y Windows Server Core (.NET6).
Las imágenes oficiales de .NET para Windows se basan en Nano Server.
> **Contexto para equipos de facturación electrónica española:** Este error es frecuente en pipelines de generación de PDFs representativos para **VERI\*FACTU** o **Facturae** que se han migrado a contenedores Docker en Windows. La solución recomendada para entornos de producción es cambiar a imágenes Linux, que además resultan más eficientes para el procesamiento de lotes **SII** de la AEAT. Los despliegues en **AWS eu-south-2 Madrid** con Amazon Linux 2023 son una arquitectura habitual para este tipo de workloads.
Para solucionar este problema, sugerimos lo siguiente:
1. Compile y despliegue su proyecto como `self-contained`. [Haga clic aquí para más información](https://github.com/dotnet/dotnet-docker/blob/main/documentation/scenarios/using-system-drawing-common.md) sobre esta opción.
2. Cambie a imágenes de contenedor basadas en **Linux** cambiando la siguiente propiedad en su archivo `.csproj`:
```xml
<!-- Change the default OS for Docker to Linux to use Linux-based images -->
<DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
```
Luego puede agregar dependencias de Linux con los siguientes comandos de shell:
```shell
# Update package lists and install necessary libraries for IronPDF on Linux
RUN apt update \
&& apt install -y libgdiplus libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 \
libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
libxrender1 libfontconfig1 libxshmfence1
```
*(Las dependencias anteriores son para Debian 11, aunque las dependencias específicas para Ubuntu, CentOS, Amazon Linux, y más se pueden ver [aquí](/get-started/linux/#docker-linux-setup))*
### Elección de imagen base para pipelines de facturación electrónica española
Para proyectos que integran IronPDF en stacks de **Facturae** (para FACe o portales de administración pública) o en aplicaciones certificadas bajo **VERI\*FACTU**, la opción de contenedores Linux ofrece ventajas adicionales:
- **Coste y rendimiento:** Las instancias de contenedor Linux en **AWS eu-south-2 Madrid** son generalmente más económicas que sus equivalentes Windows para el procesamiento de lotes nocturnos de SII.
- **Conformidad ENS:** Los sistemas de información públicos clasificados como ENS Medio o ENS Alto pueden operar sobre Linux, y el cambio a contenedores Linux elimina la dependencia de `System.Drawing` de Windows.
- **TicketBAI:** Los microservicios que generan PDFs de facturas para los territorios forales (Bizkaia, Gipuzkoa, Araba) se despliegan habitualmente en Kubernetes sobre nodos Linux; este cambio de configuración es el paso previo habitual.
## Preguntas frecuentes sobre libcef.dll en entornos españoles
**¿Por qué aparece el error libcef.dll 203 en mi pipeline de VERI*FACTU en Docker?**
El error se produce porque la imagen de contenedor .NET base para Windows (Nano Server) no incluye `System.Drawing`. Si tu pipeline de VERI\*FACTU usa Docker en Windows, cambia a una imagen Linux o compila como `self-contained`. Las imágenes basadas en Debian o Ubuntu incluyen las librerías nativas necesarias para que el motor Chromium de IronPDF funcione correctamente.
**¿Funciona IronPDF en Amazon Linux 2023 para el procesamiento de lotes SII?**
Sí. IronPDF es compatible con Amazon Linux 2023 en AWS eu-south-2 Madrid. Consulta la guía de dependencias Linux para los paquetes específicos requeridos en distribuciones basadas en Red Hat / Amazon Linux.
Error al cargar uno de los ensamblajes de Chrome (libcef.dll)
Fallo en la implementación de Chrome (error al cargar libcef.dll) (203)
Esto se debe a que System.Drawing no está incluido en Windows Nano Server y Windows Server Core (.NET6).
Las imágenes oficiales de .NET para Windows se basan en Nano Server.
Contexto para equipos de facturación electrónica española: Este error es frecuente en pipelines de generación de PDFs representativos para VERI*FACTU o Facturae que se han migrado a contenedores Docker en Windows. La solución recomendada para entornos de producción es cambiar a imágenes Linux, que además resultan más eficientes para el procesamiento de lotes SII de la AEAT. Los despliegues en AWS eu-south-2 Madrid con Amazon Linux 2023 son una arquitectura habitual para este tipo de workloads.
Para solucionar este problema, sugerimos lo siguiente:
# Update package lists and install necessary libraries for IronPDF on Linux
RUN apt update \
&& apt install -y libgdiplus libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 \
libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
libxrender1 libfontconfig1 libxshmfence1
SHELL
(Las dependencias anteriores son para Debian 11, aunque las dependencias específicas para Ubuntu, CentOS, Amazon Linux, y más se pueden ver aquí)
Elección de imagen base para pipelines de facturación electrónica española
Para proyectos que integran IronPDF en stacks de Facturae (para FACe o portales de administración pública) o en aplicaciones certificadas bajo VERI*FACTU, la opción de contenedores Linux ofrece ventajas adicionales:
Coste y rendimiento: Las instancias de contenedor Linux en AWS eu-south-2 Madrid son generalmente más económicas que sus equivalentes Windows para el procesamiento de lotes nocturnos de SII.
Conformidad ENS: Los sistemas de información públicos clasificados como ENS Medio o ENS Alto pueden operar sobre Linux, y el cambio a contenedores Linux elimina la dependencia de System.Drawing de Windows.
TicketBAI: Los microservicios que generan PDFs de facturas para los territorios forales (Bizkaia, Gipuzkoa, Araba) se despliegan habitualmente en Kubernetes sobre nodos Linux; este cambio de configuración es el paso previo habitual.
Preguntas frecuentes sobre libcef.dll en entornos españoles
¿Por qué aparece el error libcef.dll 203 en mi pipeline de VERI*FACTU en Docker?
El error se produce porque la imagen de contenedor .NET base para Windows (Nano Server) no incluye System.Drawing. Si tu pipeline de VERI*FACTU usa Docker en Windows, cambia a una imagen Linux o compila como self-contained. Las imágenes basadas en Debian o Ubuntu incluyen las librerías nativas necesarias para que el motor Chromium de IronPDF funcione correctamente.
¿Funciona IronPDF en Amazon Linux 2023 para el procesamiento de lotes SII?
Sí. IronPDF es compatible con Amazon Linux 2023 en AWS eu-south-2 Madrid. Consulta la guía de dependencias Linux para los paquetes específicos requeridos en distribuciones basadas en Red Hat / Amazon Linux.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
