Qué te compra realmente el self-hosting (y qué te cuesta)

Un convertidor público está optimizado para tareas anónimas puntuales. Autoalojar PDF123 cambia el contrato: las subidas llegan a máquinas que tú operas y todas las herramientas del catálogo se pueden alcanzar por HTTP, no solo desde un formulario del navegador.

Qué ganas

La primera compra es la localidad de los datos: los archivos llegan a tu pdfx-server, no a un almacén temporal que no controlas. La segunda es la superficie para desarrolladores en esa misma máquina: REST bajo /api/v1/…, OpenAPI en /v1/openapi.json, MCP en /mcp y pdfx --cloud apuntando a tu URL base.

Docker Compose ejecuta juntos el backend de Rust y el portal de Next.js, de modo que personas y scripts comparten un catálogo. En esa ruta no hay instalador de escritorio; el uso offline es Compose y el CLI (Self-host). El trabajo local nativo usa task pdfx:dev junto al portal; Compose usa task docker:build / task docker:up (API en :8080 y portal en :3000).

Un agente o un trabajo de CI con tu clave llama a las mismas ops que el sitio público. Combinar, Comprimir, OCR, la conversión y el resto mantienen rutas y parámetros. Esa igualdad es el producto, no un eslogan.

Los anuncios que financian el sitio público no forman parte de un despliegue autoalojado. También te ahorras la cuota anónima del servicio alojado: la planificación de capacidad pasa a ser tuya, incluidos los picos de CPU durante el OCR o las combinaciones grandes. El OCR sigue devolviendo Markdown (text/markdown) en tu máquina; mover el servidor no cambia el contrato de la op.

Qué cuesta

Asumes la disponibilidad, las actualizaciones de imagen, el disco para archivos temporales, TLS y la rotación de claves. Compose arranca rápido; mantenerlo sano es un trabajo continuo. Define SECURITY_CUSTOMGLOBALAPIKEY cuando quieras una puerta fija de clave de API en tu instancia. Las funciones opcionales (por ejemplo URL→PDF con SYSTEM_ENABLEURLTOPDF=true) son flags que activas a propósito, no valores por defecto que aparecen porque el sitio público los tenga.

Autoalojar no añade un lienzo visual de «editar PDF» por activar un flag. La superficie sigue siendo herramientas de formulario más API. Si necesitas edición en lienzo, seguirás necesitando otro producto: mover el servidor no crea esa interfaz.

Los límites de tasa y la medición dependen de cómo configures la máquina. No des por hecho que las cabeceras y los topes anunciados del sitio público se trasplantan sin cambios; lee las cabeceras que devuelve tu instancia cuando te importe el gasto. Las ops que dependen de componentes pesados (modelos de OCR, convertidores opcionales) fallan con códigos de problema estructurados missing_dependency / unavailable si el binario o el paquete de modelos no está instalado en tu imagen.

Cómo se relaciona con el sitio público

Usa el PDF123 alojado para probar sin configurar nada. Allí las herramientas del catálogo y las llamadas anónimas a /api/v1/ no piden cuenta; las respuestas anuncian X-RateLimit-* y las respuestas 429 incluyen Retry-After (límites de tasa anónimos).

Autoaloja cuando lo exijan las reglas de retención, las redes aisladas o la automatización privada. /llms.txt ayuda a los agentes a descubrir herramientas en la URL base que ejecutes; Google Search no lo considera una señal de posicionamiento. MCP y OpenAPI siguen disponibles junto al portal en esa misma base.

Cuándo no autoalojar todavía

Si solo necesitas una combinación esta tarde, el formulario alojado te basta. Si mañana y todos los días siguientes necesitas que los bytes sean privados, empieza hoy con Compose en lugar de añadir un instalador de escritorio a una costumbre de SaaS. La vía offline que mantenemos está documentada en Self-host, no en la ficha de una tienda.

Empieza por Self-host. Las claves y OpenAPI están en Desarrolladores. Para un contraste más breve con los convertidores que solo funcionan en el navegador, consulta Por qué autoalojar un toolkit PDF. Sobre por qué la vía privada es Compose y no un .exe, consulta Por qué nos saltamos la app de escritorio.