Fusionner deux contrats, compresser un rapport trop lourd pour la messagerie, caviarder un document avant de le transmettre, faire un OCR sur un scan : ces opérations sur des PDF sont quotidiennes dans toutes les entreprises. Faute d’outil interne, beaucoup d’utilisateurs se tournent vers des convertisseurs en ligne gratuits, et y déposent sans y penser des fiches de paie, des devis, des pièces d’identité ou des données clients. Pour un DSI ou un RSSI, c’est une fuite de données silencieuse, difficile à détecter et contraire aux exigences du RGPD.
Stirling PDF répond précisément à ce problème. Il s’agit d’une plateforme de traitement PDF que vous hébergez vous-même : les documents sont traités sur votre serveur et ne transitent par aucun service tiers. Le projet, l’un des plus populaires de l’écosystème auto-hébergé avec plus de 90 000 étoiles sur GitHub, a beaucoup évolué ces derniers mois. Cet article présente son fonctionnement, son installation, ses usages en entreprise et les bonnes pratiques pour le déployer proprement.
Qu’est-ce que Stirling PDF ?
Stirling PDF est une application open source, éditée par Stirling-Tools, qui regroupe plus de 50 outils PDF dans une interface web unique : fusion, découpage, réorganisation et rotation de pages, compression, OCR, conversion depuis et vers d’autres formats, ajout de filigranes, signature, caviardage, gestion des mots de passe et des métadonnées, etc. L’interface est disponible dans plus de 40 langues, dont le français.
Le projet se décline aujourd’hui en trois modes d’utilisation :
Serveur auto-hébergé : une application web accessible depuis le navigateur, avec une API REST privée ;
Client de bureau : une application installée sur le poste, utile pour les utilisateurs nomades ;
Stirling Cloud : une offre hébergée par l’éditeur, que nous n’aborderons pas ici puisque l’intérêt principal reste la maîtrise de vos données.
Côté licence, Stirling PDF suit un modèle open-core : le code est sous licence MIT par défaut, à l’exception de certains répertoires (fonctions propriétaires, SaaS, moteur de traitement avancé, client de bureau) qui disposent de leur propre licence. En pratique, la version gratuite auto-hébergée couvre l’ensemble des outils PDF, l’API REST et l’authentification unique OAuth2/OIDC, avec une limite de 5 utilisateurs.
Architecture et fonctionnement
Stirling PDF repose sur un backend Java et une interface web moderne, livrés ensemble dans une image de conteneur. Le traitement des fichiers s’appuie sur plusieurs briques open source : les conversions bureautiques utilisent LibreOffice, tandis que l’OCR exploite les fichiers de langue Tesseract (répertoire tessdata). Les paramètres sont stockés dans un fichier settings.yml, dont chaque clé peut être surchargée par une variable d’environnement, ce qui facilite les déploiements reproductibles.
L’éditeur propose trois variantes d’image :
latest: l’image standard, avec connexion et administration, environ 4 Go de mémoire conseillés ;latest-fat: ajoute un moteur d’IA embarqué (désactivé par défaut), 6 Go de mémoire conseillés ;latest-ultra-lite: uniquement les outils PDF de base, sans OCR ni conversions Office, HTML ou ebook, et sans gestion des utilisateurs (2 Go conseillés).
Les données persistantes sont réparties dans plusieurs volumes : /configs (paramètres, base intégrée, clés générées), /storage (fichiers enregistrés côté serveur), /pipeline (dossiers surveillés pour l’automatisation), /logs, /customFiles (personnalisation) et /usr/share/tessdata (langues OCR supplémentaires).
Installation avec Docker Compose
La méthode recommandée est le déploiement en conteneur avec Docker. Si vous débutez avec les fichiers Compose, les volumes et les réseaux, le TP Volumes, réseaux et Docker Compose de notre cours en accès libre pose les bases. Voici le fichier compose.yaml proposé par la documentation officielle :
services:
stirling-pdf:
image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest
container_name: stirling-pdf
ports:
- '8080:8080'
volumes:
- ./stirling-data/configs:/configs
- ./stirling-data/logs:/logs
- ./stirling-data/customFiles:/customFiles
- ./stirling-data/pipeline:/pipeline
- ./stirling-data/storage:/storage
- ./stirling-data/tessdata:/usr/share/tessdata
mem_limit: 4g
restart: unless-stopped
# Démarrage
docker compose up -d L’application est ensuite accessible sur http://<serveur>:8080. Les images Docker sont également publiées sur Docker Hub (stirlingtools/stirling-pdf) et sur le registre GitHub (ghcr.io/stirling-tools/stirling-pdf). Pour un environnement de production, préférez un tag de version figé (par exemple <version> ou <version>-fat) plutôt que latest, afin de maîtriser les mises à jour.
Premiers réglages
Avec les images latest et latest-fat, la connexion est activée et le compte par défaut est admin / stirling : changez ce mot de passe dès la première connexion. Quelques variables d’environnement utiles :
SYSTEM_DEFAULTLOCALE=fr-FR: langue par défaut de l’interface ;SECURITY_ENABLELOGIN=false: désactive la connexion (à réserver à un poste isolé, jamais à un serveur partagé) ;PUID/PGIDetUMASK: alignent les droits des fichiers créés avec ceux de l’hôte.
Pour centraliser l’authentification, la version gratuite prend en charge l’OAuth2/OIDC : vous pouvez brancher Stirling PDF sur un fournisseur d’identité comme authentik et profiter ainsi du MFA et de la gestion centralisée des comptes. Le SAML2 et la journalisation d’audit sont en revanche réservés à l’offre Enterprise.
Utilisation au quotidien et automatisation
Dans l’interface, l’utilisateur dépose ses fichiers puis enchaîne les outils : réorganiser des pages, compresser, convertir un document Word en PDF, appliquer un OCR, ajouter une signature ou caviarder des passages sensibles. Le caviardage est particulièrement intéressant pour les équipes juridiques, RH ou sécurité qui doivent anonymiser un document avant de le partager.
Pour les traitements répétitifs, Stirling PDF propose plusieurs mécanismes : des pipelines d’automatisation sans code, la surveillance de dossiers (volume /pipeline) et surtout une API REST qui couvre la quasi-totalité des outils. La documentation interactive Swagger est servie sur /swagger-ui/index.html de votre instance, et l’authentification se fait via l’en-tête X-API-KEY. Exemple de compression d’un PDF :
export STIRLING_URL="https://pdf.exemple.local"
export STIRLING_API_KEY="votre-cle-api"
curl -X POST "$STIRLING_URL/api/v1/misc/compress-pdf" \
-H "X-API-KEY: $STIRLING_API_KEY" \
-F "fileInput=@/chemin/vers/rapport.pdf" \
-F "optimizeLevel=5" \
-o rapport-compresse.pdf Cette API permet d’intégrer le traitement PDF dans vos scripts d’administration, vos workflows de GED ou vos outils d’automatisation : compression systématique des pièces jointes archivées, OCR des documents scannés pour les rendre consultables, conversion en lot de rapports bureautiques. Notez que, sur l’offre gratuite, les appels d’outils PDF par clé API et les fonctions d’automatisation avancées (Processor, IA) sont décomptés d’une allocation mensuelle : vérifiez les quotas dans la documentation avant de bâtir un traitement massif.
Cas d’usage en entreprise
Services RH et juridiques : fusion de contrats, signature, caviardage de données personnelles avant transmission à un prestataire.
Équipes IT et sécurité : anonymisation de rapports d’audit ou de pentest, suppression des métadonnées avant publication, protection par mot de passe.
Comptabilité et services généraux : OCR des factures scannées, compression avant archivage, conversion en lot de documents bureautiques.
Comparaison avec les alternatives
Convertisseurs PDF en ligne : pratiques et gratuits, mais les documents sont envoyés chez un tiers. C’est précisément le risque que Stirling PDF permet d’éliminer.
Adobe Acrobat : la référence fonctionnelle, notamment pour l’édition fine et la signature, mais sous licence commerciale par utilisateur et largement adossée au cloud de l’éditeur.
PDFsam Basic : une application de bureau open source efficace pour fusionner, découper et réorganiser des PDF, mais installée poste par poste et sans API serveur.
PDF24 Creator : un utilitaire Windows gratuit très complet, mais propriétaire et lui aussi limité au poste de travail.
Le positionnement de Stirling PDF est donc clair : un service PDF centralisé, accessible à toute l’équipe depuis le navigateur, automatisable par API et entièrement sous votre contrôle. Il ne remplace pas un éditeur PDF avancé pour la mise en page fine, mais il couvre l’immense majorité des besoins courants.
Bonnes pratiques de déploiement
Publier derrière un reverse proxy : exposez l’application en HTTPS via Traefik ou un équivalent, sans ouvrir directement le port 8080, et limitez l’accès au réseau interne ou au VPN.
Activer l’authentification : gardez la connexion activée, changez le compte
adminpar défaut et privilégiez le SSO OIDC pour bénéficier de vos politiques MFA.Dimensionner la mémoire : l’OCR et les conversions consomment des ressources ; respectez les recommandations (2 à 6 Go selon l’image) et fixez une limite mémoire au conteneur.
Choisir la bonne image : l’image
ultra-literéduit la surface d’attaque si vous n’avez besoin que des opérations de base ; n’activez le moteur d’IA de l’imagefatqu’après une analyse de risque.Sauvegarder les volumes :
/configset/storagecontiennent la configuration, la base intégrée et les fichiers des utilisateurs ; intégrez-les à votre politique de sauvegarde.Mettre à jour régulièrement : le projet publie des versions fréquemment ; utilisez des tags figés, suivez les notes de version et testez avant de déployer. Lors d’un passage depuis la V1, consultez la section dédiée aux changements incompatibles de la documentation.
Sensibiliser les utilisateurs : un outil interne n’a d’intérêt que s’il est connu. Communiquez sur son existence et rappelez pourquoi les convertisseurs en ligne sont à proscrire pour les documents internes.
Conclusion
Stirling PDF transforme un usage à risque, l’envoi de documents internes vers des services en ligne, en un service maîtrisé hébergé sur votre propre infrastructure. Installation en quelques minutes avec Docker, plus de 50 outils, SSO OIDC et API REST dans la version gratuite : pour une PME comme pour une DSI, c’est une brique simple à déployer qui réduit concrètement l’exposition des données. Commencez par un pilote avec quelques utilisateurs, mesurez l’adoption, puis élargissez en fonction des besoins et des limites de licence.
À lire aussi : Nextcloud : une solution complète de Cloud Privé · Forgejo : la forge Git open source et auto-hébergée pour vos équipes IT

