Sign inSign up

maricalivius/convert-api

By maricalivius

Updated 7 months ago

Lightweight TypeScript / Node.js API for high-performance Word-to-PDF conversion using Gotenberg 8.

Image
API management
0

10K+

maricalivius/convert-api repository overview

POC -- High Performance Word to PDF Conversion

This project demonstrates an optimized document conversion service using a micro-services architecture with Gotenberg.

🚀 Overview

The initial proof of concept relied on a local LibreOffice wrapper and showed limited performance.
This improved version leverages Gotenberg 8 running in Docker on SAP BTP (Cloud Foundry).

⚡ Performance Gain
  • Small documents: ~1--2 seconds\
  • Large documents (100+ pages): ~6 seconds\
  • Previous approach: up to 70 seconds

🛠 Tech Stack

  • TypeScript (Node.js / Express)
  • Gotenberg 8
  • Docker
  • SAP BTP (Cloud Foundry)

🐳 Architecture

  • Converter API (Express) handles incoming requests\
  • Gotenberg container performs document rendering\
  • Gzip compression reduces transfer latency

📡 API

  • GET / → Health check\
  • POST /convert → Upload .docx file (form-data: file)\
  • Response: PDF (gzip compressed)

🚀 Deployment

docker build --platform linux/amd64 -t your-image-name ./api
docker push your-image-name
cf push

This POC validates that a containerized micro-service architecture is suitable for high-performance document conversion in production environments.

Tag summary

Content type

Image

Digest

sha256:af71175d2

Size

73.2 MB

Last updated

7 months ago

docker pull maricalivius/convert-api