Sign inSign up

maricalivius/convert-api

By maricalivius

•Updated 8 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

8 months ago

docker pull maricalivius/convert-api