Développement

Gotenberg

API HTTP de génération de PDF self-hosted : convertissez HTML, URLs, Markdown et documents LibreOffice en PDF en un appel REST.

Documentation officielle

À propos de Gotenberg

Gotenberg (licence MIT, 8 k+ étoiles GitHub) est un microservice HTTP containerisé pour générer des PDF depuis HTML, URLs, Markdown et documents Office (DOCX, XLSX, PPTX) via une API REST épurée. Déployez-le sur un VPS et remplacez les services PDF SaaS facturés à la page par un coût mensuel fixe. Chromium et LibreOffice sont intégrés dans le conteneur unique — aucune dépendance supplémentaire. Utilisez-le pour générer des factures, rapports, contrats ou tout document depuis vos applications backend.

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles
Ubuntu 24.04
Application
Gotenberg
RAM minimum
500 Mo minimum (rendu Chromium), 1 Go recommandé
CPU minimum
1 vCPU
Accès
root par SSH

Fonctionnalités clés

  • HTML→PDF via Chromium : support complet CSS, JavaScript et polices web.
  • URL→PDF : capturez n'importe quelle page web côté serveur — utile pour rapports et archivage.
  • Conversion LibreOffice : DOCX, XLSX, PPTX, ODP et plus de 20 formats en PDF sans Microsoft Office.
  • Fusion de PDF : combinez plusieurs fichiers PDF en un seul document en un appel.
  • Microservice sans état : sans base de données ni couche d'authentification — ajoutez votre reverse proxy devant.
  • Licence MIT — aucune facturation à la page ou au document.

Quand utiliser cette solution ?

Génération de factures et contrats

Produisez vos modèles HTML de factures en PDF côté serveur et envoyez-les en pièces jointes ou stockez-les en S3. Aucune facturation par document, aucun accès tiers à vos données financières.

Export de rapports dans les produits SaaS

Ajoutez un bouton « Télécharger en PDF » à votre tableau de bord. Votre backend envoie le rapport HTML à Gotenberg et diffuse le PDF directement à l'utilisateur — sans bibliothèque frontend ni extension navigateur.

Pipeline de conversion de formats documentaires

Convertissez les fichiers DOCX ou XLSX téléversés en PDF pour l'archivage, la prévisualisation ou les flux de signature électronique. La route LibreOffice de Gotenberg gère la conversion sans installer Office sur votre serveur.

Guide

Déployer Gotenberg sur votre VPS

  1. Déployer depuis la Marketplace

    Ouvrez le tableau de bord ServOrbit, rendez-vous dans Marketplace → Développement → Gotenberg, et cliquez sur Déployer. Docker tire l'image gotenberg/gotenberg:8 — elle inclut Chromium et LibreOffice — et démarre le serveur HTTP sur le port 3000. Le service est prêt en moins de 30 secondes.

  2. Envoyer votre première requête HTML vers PDF

    Depuis votre application ou un terminal, envoyez votre HTML à la route Chromium : ` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/html' \ --form '[email protected]' \ -o facture.pdf` Gotenberg rend la page avec une instance Chromium complète et retourne le PDF en flux binaire.

  3. Convertir une URL en PDF

    Pour capturer une page web en direct : ` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/url' \ --form 'url=https://votre-page-rapport.com' \ -o rapport.pdf` Utile pour archiver des vues de tableau de bord, générer des rapports hebdomadaires ou capturer des reçus.

  4. Ajouter une authentification

    Gotenberg n'a pas d'authentification intégrée. Protégez l'API en la plaçant derrière un reverse proxy (nginx) avec une authentification HTTP basic ou en restreignant l'accès à un réseau interne uniquement. Le schéma standard est de garder le port 3000 lié à 127.0.0.1 et de l'appeler depuis le backend de votre application sur le même serveur.

Questions fréquentes

Questions sur Gotenberg

← Retour à DéveloppementToutes les applications
Oui. Gotenberg est sans état et horizontalement scalable. Un seul conteneur gère des dizaines de requêtes concurrentes ; ajoutez davantage de conteneurs derrière un répartiteur de charge pour les charges de travail à haut débit.

Intégrer le bouton de déploiement

Vous maintenez un projet qui utilise Gotenberg ? Ce bouton permet à vos lecteurs de le déployer sur un VPS en un clic, sans lire de documentation Docker.

Deploy Gotenberg on ServOrbit
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>

Le bouton pointe vers la commande d'un VPS avec le template présélectionné. L'image est servie depuis servorbit.com — rien à héberger de votre côté.

Solutions complémentaires

Collaboration & Productivité

Penpot

La plateforme de design open-source auto-hébergeable — alternative à Figma pour les équipes produit, avec collaboration en temps réel, prototypage interactif et export CSS live.

Collaboration & Productivité

Stirling PDF

Suite PDF complète self-hosted, #1 application PDF sur GitHub : convertir, fusionner, diviser, compresser, OCR, filigraner et 50+ opérations — aucune donnée envoyée en nuage.

Besoin d'aide ?

Parcourez notre centre d'aide et notre FAQ, ou contactez notre équipe — rappel, WhatsApp ou e-mail.

Écrire sur WhatsApps'ouvre dans un nouvel onglet
ou nous écrire