Comment installer Stirling-PDF sur Saplo (une suite d'outils PDF sans envoyer de documents à l'extérieur)

Une facture à paginer, un scan de contrat à compresser avant de l'envoyer par e-mail, un ancien document à passer par l'OCR avant de l'archiver. Chacune de ces actions a son service gratuit sur Internet, mais chacune d'elles signifie télécharger le document sur le serveur de quelqu'un d'autre et des limitations dans le plan gratuit (limite de taille de fichier, limite d'opérations quotidiennes, filigrane sur le résultat). Stirling-PDF résout ce problème en tant que conteneur Docker unique sur ton propre Box : les mêmes opérations, sans rien envoyer à l'extérieur et sans compter le nombre de fois où tu as utilisé l'outil aujourd'hui. Dans ce tutoriel, nous te montrons comment installer Stirling-PDF sur Saplo.

Qu'est-ce que Stirling-PDF et à qui s'adresse-t-il ?

Stirling-PDF est une boîte à outils PDF auto-hébergée qui fonctionne dans le navigateur, basée sur l'image Docker officielle stirlingtools/stirling-pdf. En un seul endroit, tu trouveras plus de cinquante opérations : fusionner et diviser des fichiers, convertir des PDF en Word, Excel ou image et inversement, compresser, OCR des pages scannées, signer, supprimer des mots de passe et bien d'autres choses encore. Il conviendra principalement :

• aux bureaux qui fusionnent, divisent ou compressent quotidiennement des scans et des factures au format PDF,
• à toute personne souhaitant numériser un document papier en texte consultable (OCR) sans le télécharger vers un service tiers,
• aux entreprises qui ont besoin d'une conversion pratique de PDF vers d'autres formats et inversement, sans les limites quotidiennes des outils en ligne gratuits.

Il s'agit d'une niche différente de Documenso, où il s'agit de la signature électronique d'un accord entre les parties. Stirling-PDF se concentre sur le travail avec le fichier PDF lui-même, et non sur le flux de documents.

Conditions requises

Pour installer Stirling-PDF sur Saplo, tu as besoin de :

• Une Box avec Docker en cours d'exécution (le moteur l'active automatiquement lors de l'installation depuis le Catalogue, le nesting dans le conteneur est requis, ce que Saplo propose par défaut),
• Un minimum de 2 GB de RAM et 5 GB d'espace disque pour l'application elle-même. En pratique, cela correspond à la Box L pour 139 € par an : la Box M a exactement 2 GB de RAM, soit la quantité requise par l'application seule, sans réserve pour le système et les autres processus. Le moteur Saplo recommande donc le plan supérieur dans ce cas,
• Un domaine ou un sous-domaine *.saploapp.pl inclus dans le prix de chaque plan, où l'outil sera hébergé,
• Tu N'as PAS besoin d'une base de données séparée, Stirling-PDF ne conserve pas de bibliothèque de documents permanente : les fichiers entrent, sont traités et sortent, rien n'est enregistré de manière permanente.

Après l'installation sur une Box L, il reste 3,8 GB de RAM et 50 GB de disque, ce qui te permet d'y héberger jusqu'à 137 autres applications du Catalogue, comme Vaultwarden ou Excalidraw.

Installation étape par étape

1. Dans le Panneau Saplo, va dans le Catalogue d'applications et choisis Stirling-PDF (catégorie « Business »).
2. Indique une Box L ou supérieure ainsi qu'un domaine ou un sous-domaine sous lequel l'outil fonctionnera.
3. Confirme l'installation. Le moteur installe un conteneur à partir de l'image officielle stirlingtools/stirling-pdf dans sa version complète (avec LibreOffice pour la conversion de formats et Tesseract pour l'OCR inclus), l'expose uniquement sur le loopback de la Box et le connecte à Nginx, qui le sert sous le domaine spécifié avec un SSL gratuit.
4. Après le démarrage du conteneur, le moteur vérifie en outre si Stirling-PDF répond effectivement en HTTP sur son propre point de terminaison de Statut, car le Statut « le conteneur fonctionne » ne signifie pas que le processus interne n'est pas tombé dans une boucle de redémarrages peu de temps après.
5. Une fois l'installation terminée, Stirling-PDF est disponible sous le domaine indiqué et prêt à fonctionner, sans qu'aucun Compte ne soit nécessaire.

Sécurité : pas de connexion par défaut

Stirling-PDF sur Saplo démarre sans connexion, exactement comme la démo officielle du projet : quiconque connaît l'adresse peut traiter des fichiers. C'est une décision délibérée, le même modèle que pour ntfy dans le catalogue Saplo. Si tu as besoin d'une instance privée accessible uniquement à toi ou à ton équipe, tu actives manuellement la connexion : dans les options du conteneur dans le panneau, tu définis la variable SECURITY_ENABLELOGIN sur true et tu redémarres l'application. Lors du premier démarrage avec la connexion activée, Stirling-PDF crée un compte admin/admin, qui doit être immédiatement modifié.

L'OCR en polonais nécessite l'installation d'un pack de langue

L'image Stirling-PDF intègre des packs de langue Tesseract pour l'anglais, l'allemand, le français, le portugais et le chinois simplifié, mais SANS le polonais. Pour que l'OCR fonctionne en polonais, il faut ajouter le fichier pol.traineddata (disponible par exemple dans le dépôt tessdata_fast du projet Tesseract) et le copier dans le volume de données du conteneur via SSH, conformément aux instructions automatiquement enregistrées dans le fichier STIRLING-PDF-SETUP.txt sur la Box après l'installation. Sans cette étape, l'OCR fonctionne, mais il ne reconnaîtra pas correctement les signes diacritiques polonais dans le texte numérisé.

Stirling-PDF sur Saplo vs outils en ligne

Questions fréquentes

Est-ce que Stirling-PDF requiert un compte ou une connexion ? Non, de base, l'instance fonctionne immédiatement sans connexion, comme la démo officielle. Tu peux activer la connexion toi-même dans les options du conteneur si tu as besoin d'une instance privée.

L'OCR fonctionne-t-il en français par défaut ? Non, l'image n'inclut que l'anglais, l'allemand, le français, le portugais et le chinois simplifié. Le français doit être ajouté manuellement. Les instructions sont disponibles dans le fichier STIRLING-PDF-SETUP.txt sur la Box après l'installation.

Stirling-PDF a-t-il besoin d'une base de données séparée ? Non, toute l'application fonctionne comme un conteneur unique sans base de données. Les documents ne sont pas stockés de manière permanente, ils sont seulement traités et renvoyés.

Les fichiers restent-ils sur le serveur après traitement ? Non, Stirling-PDF n'est pas un système de stockage de fichiers. Le document est reçu, traité et renvoyé, rien n'est enregistré de manière permanente dans le conteneur.

Quelle est la limite de taille des fichiers ? Par défaut, c'est 200 Mo par fichier. La variable SYSTEM_MAXFILESIZE dans les options du conteneur peut être augmentée si tu as besoin de plus.

Si dans ton entreprise, tu traites des dizaines de fichiers PDF chaque jour, comme la fusion d'offres, la compression de scans, l'OCR de factures, écris-nous. Nous t'aiderons à choisir la Box adaptée à tes outils.