Wat self-hosting u echt oplevert (en wat het kost)

Een openbare converter is geoptimaliseerd voor anonieme eenmalige taken. Self-hosting van PDF123 verandert het contract: geüploade bestanden komen terecht op machines die u zelf beheert, en elke catalogustool is bereikbaar via HTTP, niet alleen via een browserformulier.

Wat u koopt

De eerste aankoop is datalokaliteit. Bestanden komen op uw pdfx-server terecht, niet in een tijdelijke opslag die u niet zelf draait. De tweede aankoop is het oppervlak voor ontwikkelaars op diezelfde machine: REST onder /api/v1/…, OpenAPI op /v1/openapi.json, MCP op /mcp en pdfx --cloud gericht op uw basis-URL.

Docker Compose draait de Rust-backend en de Next.js-portal samen, zodat mensen en scripts één catalogus delen. Er zit geen desktopinstallatie in dat pad; offline gebruik betekent Compose en de CLI (Self-host). Lokaal ontwikkelen gebeurt met task pdfx:dev naast de portal; Compose gebruikt task docker:build / task docker:up (API op :8080, portal op :3000).

Een agent of CI-taak met uw sleutel roept dezelfde bewerkingen aan als de openbare site. Merge, Compress, OCR, conversie en de rest houden dezelfde paden en parameters. Die gelijkheid is het product, geen slogan.

Advertenties die de openbare site financieren, horen niet bij een self-hosted uitrol. U ontwijkt ook het verhaal van het gehoste anonieme quotum: capaciteitsplanning wordt uw verantwoordelijkheid, inclusief CPU-pieken tijdens OCR of grote samenvoegingen. OCR levert op uw machine nog steeds Markdown (text/markdown) terug; de server verplaatsen verandert het contract van de bewerking niet.

Wat het kost

U bent zelf verantwoordelijk voor uptime, image-updates, schijfruimte voor tijdelijke bestanden, TLS en het roteren van sleutels. Compose is snel gestart; het gezond houden is doorlopend werk. Stel SECURITY_CUSTOMGLOBALAPIKEY in wanneer u een vaste drempel met API-sleutels op uw exemplaar wilt. Optionele functies (bijvoorbeeld URL→PDF via SYSTEM_ENABLEURLTOPDF=true) zijn opties die u bewust aanzet, geen standaardwaarden die verschijnen omdat de openbare site ze heeft.

Self-hosting voegt geen visueel canvas voor “Edit PDF” toe door een optie om te zetten. Het oppervlak blijft formuliertools plus API. Hebt u canvasbewerking nodig, dan hebt u nog steeds een ander product nodig; de server verplaatsen verzint die UI niet.

Rate limits en het gedrag van de gebruiksmeting volgen hoe u de machine configureert. Ga er niet van uit dat de vermelde headers en limieten van de openbare site ongewijzigd meeverhuizen; lees de headers die uw exemplaar teruggeeft wanneer het budget u aangaat. Bewerkingen met zware afhankelijkheden (OCR-modellen, optionele converters) mislukken met gestructureerde probleemcodes als missing_dependency of unavailable wanneer het programma of het modelpakket niet in uw image zit.

Hoe het zich verhoudt tot de openbare site

Gebruik gehost PDF123 voor proeven zonder installatie. Catalogustools en anonieme aanroepen naar /api/v1/ hebben daar geen account nodig; antwoorden vermelden X-RateLimit-* en 429-antwoorden bevatten Retry-After (anonieme rate limiting).

Self-host wanneer bewaarregels, geïsoleerde netwerken of privéautomatisering dat vereisen. /llms.txt helpt agents tools te ontdekken op welke basis-URL u ook draait; Google Search behandelt het niet als een rankingsignaal. MCP en OpenAPI blijven naast de portal beschikbaar op diezelfde basis.

Wanneer u nog niet moet self-hosten

Hebt u vanmiddag alleen één merge nodig, dan is het gehoste formulier genoeg. Hebt u morgen en elke dag daarna privébestanden nodig, begin dan nu met Compose in plaats van een desktopinstallatie op een SaaS-gewoonte te plakken. Het verhaal voor offline gebruik dat wij ondersteunen, staat op Self-host, niet in een winkelpagina.

Begin bij Self-host. Sleutels en OpenAPI staan op Developers. Voor een kortere vergelijking met browserconverters, zie Why self-host a PDF toolkit. Waarom Compose het privépad is in plaats van een .exe, leest u in Why we skipped the desktop app.