¿Admite fuentes personalizadas y CSS?

Sí. La ruta Chromium renderiza su HTML con un motor de navegador completo — las fuentes web (Google Fonts a través de CDN o autoalojadas), las variables CSS, flexbox, grid y el contenido gestionado por JavaScript son todos compatibles.

¿Puede convertir archivos Word o Excel a PDF?

Sí. La ruta LibreOffice (POST /forms/libreoffice/convert) acepta DOCX, XLSX, PPTX, ODT, ODS, ODP y más de 20 formatos adicionales. LibreOffice está integrado en la imagen gotenberg/gotenberg:8.

¿Gotenberg almacena los archivos subidos?

No. Gotenberg es un servicio sin estado. Los archivos se procesan en memoria durante la petición y el PDF se transmite directamente en la respuesta. Nada se conserva en el disco una vez finalizada la respuesta — adecuado para documentos sensibles.

¿Cuánta RAM se necesita?

En reposo, el contenedor Gotenberg utiliza menos de 200 MB de RAM. Durante el renderizado activo de Chromium, cuente entre 300 y 500 MB por conversión concurrente. Un VPS de 1 GB gestiona las cargas ligeras; se recomienda un plan de 2 GB para la generación continua de documentos.

Poner en marcha rápidamente un proyecto de software.

Gotenberg

API HTTP de generación de PDF autoalojada: convierta HTML, URLs, Markdown y documentos LibreOffice a PDF con una sola llamada REST.

500 MB mínimo (renderizado Chromium), 1 GB recomendado RAM 1 vCPU Disponible

Gotenberg (licencia MIT, 8 k+ estrellas en GitHub) es un microservicio HTTP en contenedor para generar PDF a partir de HTML, URLs, Markdown y documentos Office (DOCX, XLSX, PPTX) mediante una API REST depurada. Despliéguelo en un VPS y sustituya los servicios PDF SaaS facturados por página por un coste mensual fijo. Chromium y LibreOffice están integrados en el contenedor único — sin dependencias adicionales. Úselo para generar facturas, informes, contratos o cualquier documento desde sus aplicaciones backend.

Funcionalidades clave

HTML→PDF mediante Chromium: compatibilidad completa con CSS, JavaScript y fuentes web.

URL→PDF: capture cualquier página web desde el servidor — útil para informes y archivado.

Conversión LibreOffice: DOCX, XLSX, PPTX, ODP y más de 20 formatos a PDF sin Microsoft Office.

Fusión de PDF: combine varios archivos PDF en un solo documento con una sola llamada.

Microservicio sin estado: sin base de datos ni capa de autenticación — añada su reverse proxy por delante.

Licencia MIT — sin facturación por página ni por documento.

¿Cuándo usar esta solución?

1

Generación de facturas y contratos

Convierta sus plantillas HTML de facturas en PDF desde el servidor y envíelas como archivos adjuntos o almacénelas en S3. Sin facturación por documento, sin acceso de terceros a sus datos financieros.

2

Exportación de informes en los productos SaaS

Añada un botón «Descargar en PDF» a su panel de control. Su backend envía el informe HTML a Gotenberg y transmite el PDF directamente al usuario — sin biblioteca frontend ni extensión de navegador.

3

Pipeline de conversión de formatos documentales

Convierta a PDF los archivos DOCX o XLSX subidos para el archivado, la vista previa o los flujos de firma electrónica. La ruta LibreOffice de Gotenberg gestiona la conversión sin instalar Office en su servidor.

Desplegar Gotenberg en su VPS

Guía optimizada para los VPS Cloud ServOrbit.

01

Desplegar desde el Marketplace

Abra el panel de control de ServOrbit, vaya a Marketplace → Desarrollo → Gotenberg y haga clic en Desplegar. Docker descarga la imagen gotenberg/gotenberg:8 — incluye Chromium y LibreOffice — y arranca el servidor HTTP en el puerto 3000. El servicio está listo en menos de 30 segundos.

02

Enviar su primera petición de HTML a PDF

Desde su aplicación o desde un terminal, envíe su HTML a la ruta Chromium: ` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/html' \ --form '[email protected]' \ -o facture.pdf` Gotenberg renderiza la página con una instancia completa de Chromium y devuelve el PDF como flujo binario.

03

Convertir una URL a PDF

Para capturar una página web en directo: ` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/url' \ --form 'url=https://votre-page-rapport.com' \ -o rapport.pdf` Útil para archivar vistas de panel de control, generar informes semanales o capturar recibos.

04

Añadir una autenticación

Gotenberg no tiene autenticación integrada. Proteja la API colocándola detrás de un reverse proxy (nginx) con autenticación HTTP basic o restringiendo el acceso únicamente a una red interna. El esquema estándar consiste en mantener el puerto 3000 vinculado a 127.0.0.1 y llamarlo desde el backend de su aplicación en el mismo servidor.

Preguntas frecuentes

Sí. Gotenberg no mantiene estado y es escalable horizontalmente. Un solo contenedor gestiona decenas de peticiones concurrentes; añada más contenedores detrás de un balanceador de carga para las cargas de trabajo de alto rendimiento.

Integrar el botón de despliegue

¿Mantiene un proyecto que utiliza Gotenberg? Este botón permite a sus lectores desplegarlo en un VPS con un clic, sin leer documentación de Docker.

Markdown

[![Deploy Gotenberg on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=gotenberg&utm_source=deploy-badge&utm_medium=referral&utm_campaign=gotenberg)

HTML

<a href="https://servorbit.com/vps-cloud?template=gotenberg&utm_source=deploy-badge&utm_medium=referral&utm_campaign=gotenberg"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Gotenberg on ServOrbit" height="40"></a>

El botón lleva al pedido de un VPS con la plantilla preseleccionada. La imagen se sirve desde servorbit.com: no tiene que alojar nada por su parte.

Soluciones complementarias

Colaboración y productividad

Penpot

La plataforma de diseño de código abierto autoalojable — alternativa a Figma para los equipos de producto, con colaboración en tiempo real, prototipado interactivo y exportación de CSS en vivo.