Ce que l’auto-hébergement vous apporte vraiment (et ce qu’il coûte)
Auto-héberger PDF123 garde les téléversements sur votre pdfx-server et expose le même catalogue REST, MCP et CLI, en échange de coûts d’exploitation.
Un convertisseur public optimise les usages ponctuels anonymes. Auto-héberger PDF123 change le contrat : les téléversements arrivent sur des machines que vous exploitez, et chaque outil du catalogue est accessible en HTTP, pas seulement par un formulaire de navigateur.
Ce que vous achetez
La localisation des données est le premier acquis. Les fichiers arrivent sur votre pdfx-server, pas dans un stockage temporaire que vous n’exploitez pas. Le second acquis est la surface développeur sur cette même machine : REST sous /api/v1/…, OpenAPI à /v1/openapi.json, MCP à /mcp et pdfx --cloud pointé vers votre URL de base.
Docker Compose exécute le backend Rust et le portail Next.js ensemble, pour que les humains et les scripts partagent un même catalogue. Aucun installateur de bureau n’intervient dans ce chemin ; l’usage hors ligne repose sur Compose et la CLI (Auto-hébergement). Le développement local natif utilise task pdfx:dev à côté du portail ; Compose utilise task docker:build / task docker:up (API :8080, portail :3000).
Un agent ou une tâche CI muni de votre clé appelle les mêmes opérations que le site public. Fusionner, Compresser, OCR, la conversion et le reste conservent les mêmes chemins et les mêmes paramètres. Cette identité est le produit, pas un slogan.
Les publicités qui financent le site public ne font pas partie d’un déploiement auto-hébergé. Vous échappez aussi à la logique de quota anonyme de l’offre hébergée : la planification de capacité vous revient, y compris les pics de CPU pendant l’OCR ou les fusions volumineuses. L’OCR renvoie toujours du Markdown (text/markdown) sur votre machine ; déplacer le serveur ne change pas le contrat d’opération.
Ce que cela coûte
Vous assumez la disponibilité, les mises à niveau des images, le disque pour les fichiers temporaires, le TLS et la rotation des clés. Compose démarre vite ; le maintenir en bonne santé est un travail continu. Définissez SECURITY_CUSTOMGLOBALAPIKEY si vous voulez une clé API fixe protégeant votre instance. Les fonctions optionnelles (par exemple URL→PDF via SYSTEM_ENABLEURLTOPDF=true) sont des options que vous activez délibérément, pas des valeurs par défaut présentes parce que le site public les propose.
L’auto-hébergement n’ajoute pas d’éditeur graphique « Edit PDF » en basculant une option. La surface reste des outils à formulaire plus une API. S’il vous faut un éditeur sur toile, il vous faut un autre produit : déplacer le serveur ne crée pas cette interface.
Les limites de débit et le comptage dépendent de la configuration de votre machine. Ne supposez pas que les en-têtes et les plafonds annoncés du site public s’appliquent tels quels ; lisez les en-têtes renvoyés par votre instance lorsque le budget compte. Les opérations gourmandes en dépendances (modèles OCR, convertisseurs optionnels) échouent avec des codes structurés missing_dependency / unavailable si le binaire ou le lot de modèles n’est pas installé dans votre image.
Rapports avec le site public
Utilisez PDF123 hébergé pour des essais sans installation. Les outils du catalogue et les appels anonymes à /api/v1/ n’y exigent aucun compte ; les réponses exposent X-RateLimit-* et les réponses 429 incluent Retry-After (limitation de débit anonyme).
Auto-hébergez quand les règles de conservation, des réseaux isolés ou une automatisation privée l’exigent. /llms.txt aide les agents à découvrir les outils sur l’URL de base que vous exploitez ; Google Search n’y voit pas un signal de classement. MCP et OpenAPI restent disponibles à côté du portail sur cette même base.
Quand ne pas encore auto-héberger
S’il ne vous faut qu’une fusion cet après-midi, le formulaire hébergé suffit. S’il vous faut des octets privés demain et chaque jour ensuite, partez de Compose dès maintenant plutôt que de greffer un installateur de bureau sur une habitude SaaS. La solution hors ligne que nous prenons en charge est documentée sur Auto-hébergement, pas dans une fiche de magasin d’applications.
Commencez par Auto-hébergement. Les clés et OpenAPI se trouvent sur Développeurs. Pour un contraste plus court avec les convertisseurs purement web, voir Pourquoi auto-héberger une boîte à outils PDF. Pour comprendre pourquoi Compose est la voie privée plutôt qu’un .exe, voir Pourquoi nous avons renoncé à l’application de bureau.