Cómo instalar Stirling-PDF en Saplo (herramientas PDF sin enviar documentos al exterior)

Una factura para paginar, un contrato escaneado para comprimir antes de enviarlo por correo electrónico, un documento antiguo para pasar por OCR antes de archivarlo. Cada una de estas actividades tiene su propio servicio gratuito en internet, pero cada uno de ellos implica subir el documento a un servidor externo y limitaciones en el plan gratuito (límite de tamaño de archivo, límite de operaciones diarias, marca de agua en el resultado). Stirling-PDF lo resuelve como un solo contenedor Docker en tu propio Box: las mismas operaciones, sin enviar nada al exterior y sin contar cuántas veces has utilizado la herramienta hoy. En este tutorial te mostramos cómo configurar Stirling-PDF en Saplo.

Qué es Stirling-PDF y para quién es útil

Stirling-PDF es una caja de herramientas de PDF autohospedada que funciona en el navegador, basada en la imagen oficial de Docker stirlingtools/stirling-pdf. En un solo lugar, encontrarás más de cincuenta operaciones: combinar y dividir archivos, convertir PDF a Word, Excel o imagen y viceversa, compresión, OCR de páginas escaneadas, firma, eliminación de contraseñas y mucho más. Será útil principalmente para:

• Una oficina que diariamente combina, divide o comprime escaneos y facturas en PDF.
• Cualquiera que quiera escanear un documento en papel a texto editable (OCR) sin subirlo a un servicio externo.
• Una empresa que necesita una conversión cómoda de PDF a otros formatos y viceversa, sin los límites diarios de las herramientas gratuitas en línea.

Este es un nicho diferente al de Documenso, que se centra en la firma electrónica de contratos entre partes. Stirling-PDF se concentra en el trabajo con el archivo PDF en sí, no en el flujo de documentos.

Requisitos

Para instalar Stirling-PDF en Saplo, necesitas:

• Un Box con Docker en ejecución (el motor lo activa automáticamente al instalar desde el catálogo, se requiere anidamiento en el contenedor, algo que Saplo tiene por defecto).
• Un mínimo de 2 GB de RAM y 5 GB de espacio en disco para la aplicación. En la práctica, un Box L de 139 € al año es suficiente: el Box M tiene exactamente 2 GB de RAM, que es lo que la aplicación requiere por sí sola, sin margen para el sistema y otros procesos, por lo que el motor de Saplo en este caso recomienda un plan superior.
• Un Dominio o subdominio *.saploapp.pl incluido en el precio de cada plan, donde se alojará la herramienta.
• NO necesitas una base de datos separada, Stirling-PDF no mantiene una biblioteca de documentos persistente: los archivos entran, se procesan y salen, nada se guarda permanentemente.

Después de la instalación, un Box L tendrá 3,8 GB de RAM y 50 GB de disco disponibles, lo que significa que aún puedes alojar hasta 137 aplicaciones adicionales del catálogo, como Vaultwarden o Excalidraw.

Instalación paso a paso

1. En el panel de Saplo, ve a Catálogo de aplicaciones y selecciona Stirling-PDF (categoría "Negocios").
2. Elige un Box L o superior y el dominio o subdominio bajo el cual funcionará la herramienta.
3. Confirma la instalación. El motor implementa un contenedor desde la imagen oficial stirlingtools/stirling-pdf en la versión completa (con LibreOffice para la conversión de formatos y Tesseract para OCR), lo expone solo en el loopback del Box y lo conecta a Nginx, que lo sirve bajo el dominio especificado con SSL gratuito.
4. Después de que el contenedor se inicie, el motor comprueba adicionalmente si Stirling-PDF realmente responde a HTTP en su propio endpoint de estado, ya que el estado "el contenedor está funcionando" no significa que el proceso interno no haya entrado en un bucle de reinicios un momento después.
5. Una vez completada la instalación, Stirling-PDF está disponible bajo el dominio especificado y listo para usar, sin necesidad de ninguna cuenta.

Seguridad: sin inicio de sesión por defecto

Stirling-PDF en Saplo se inicia sin inicio de sesión, tal como la demo oficial del proyecto: cualquiera que conozca la dirección puede procesar archivos. Es una decisión consciente, el mismo modelo que con ntfy en el catálogo de Saplo. Si necesitas una instancia privada disponible solo para ti o tu equipo, habilitas el inicio de sesión manualmente: en las opciones del contenedor en el panel, estableces la variable SECURITY_ENABLELOGIN en true y reinicias la aplicación. En el primer inicio con el inicio de sesión habilitado, Stirling-PDF crea la cuenta admin/admin, que debe cambiarse inmediatamente.

El OCR en español requiere la instalación de un paquete de idioma

La imagen de Stirling-PDF tiene paquetes de idioma Tesseract incorporados para inglés, alemán, francés, portugués y chino simplificado, pero NO para español. Para que el OCR funcione en español, debes añadir el archivo pol.traineddata (disponible, por ejemplo, en el repositorio tessdata_fast del proyecto Tesseract) y copiarlo al volumen de datos del contenedor a través de SSH, siguiendo las instrucciones guardadas automáticamente en el archivo STIRLING-PDF-SETUP.txt en el Box después de la instalación. Sin este paso, el OCR funcionará, pero no reconocerá correctamente los caracteres diacríticos españoles en el texto escaneado.

Stirling-PDF en Saplo vs. herramientas online

Preguntas frecuentes

¿Stirling-PDF requiere una cuenta o inicio de sesión? No, la instancia funciona de inmediato sin necesidad de iniciar sesión, al igual que la demo oficial. Puedes activar el inicio de sesión en las opciones del contenedor si necesitas una instancia privada.

¿El OCR funciona en español de forma predeterminada? No, la imagen solo incluye inglés, alemán, francés, portugués y chino simplificado. El español debe añadirse manualmente; las instrucciones están en el archivo STIRLING-PDF-SETUP.txt en el Box después de la instalación.

¿Stirling-PDF necesita una base de datos separada? No, toda la aplicación funciona como un único contenedor sin base de datos; los documentos no se almacenan permanentemente, solo se procesan y se envían.

¿Los archivos permanecen en el servidor después de ser procesados? No, Stirling-PDF no es un almacén de archivos; un documento entra, se procesa y sale, nada se guarda permanentemente en el contenedor.

¿Cuál es el límite de tamaño de archivo? Por defecto, 200 MB por archivo. La variable SYSTEM_MAXFILESIZE en las opciones del contenedor se puede aumentar si necesitas más.

Si en tu empresa manejas decenas de archivos PDF al día, combinando ofertas, comprimiendo escaneos, o realizando OCR de facturas, escríbenos. Te ayudaremos a elegir el Box adecuado para tu conjunto de herramientas.