Comment installer Stirling PDF avec Docker, étape par étape

L'installation de Stirling PDF avec Docker vous permet de transformer l'application en un serveur privé pour gérer les documents PDFUne fois déployé, vous pouvez y accéder depuis n'importe quel ordinateur, téléphone portable ou tablette du réseau à l'aide d'un navigateur Web, sans avoir à installer le programme sur chaque appareil.

Les fichiers sont envoyés au serveur que vous configurez, et non aux serveurs de Stirling PDF. Vous bénéficiez ainsi d'un meilleur contrôle sur vos documents, même si la confidentialité finale dépend également de vous. où se trouve le serveur, qui peut y accéder et comment la connexion est protégée.

Si vous comptez utiliser l'outil uniquement depuis un seul ordinateur, l'application native sera peut-être plus simple. Dans ce cas, consultez la documentation. Installer Stirling PDF sur Windows sans configurer Docker ni publier de service réseau.

Quelle image PDF de Stirling choisir ?

Stirling PDF publie trois variantes de son image. Le choix influe sur les fonctionnalités disponibles, l'espace occupé et les ressources nécessaires.

Version	Étiquette	Utilisation recommandée
Standard	latest	La plupart des utilisateurs et serveurs à domicile
Graisse	latest-fat	Compatibilité maximale, polices et outils supplémentaires
Ultra-léger	latest-ultra-lite	Raspberry Pi, petits VPS et opérations de base

L'image latest Cette option est recommandée si vous n'avez pas d'exigences particulières. Elle inclut les fonctionnalités habituelles de gestion, de conversion, de reconnaissance optique de caractères (OCR) et de sécurité, tout en conservant une taille raisonnable.

La variante latest-fat Il inclut davantage de polices et d'outils optionnels, ce qui peut améliorer la compatibilité pour certaines conversions. En contrepartie, il nécessite plus d'espace de stockage.

latest-ultra-lite Il réduit la taille et la consommation d'énergie pour les appareils aux performances limitées, mais certaines fonctionnalités sont absentes. Il convient pour fusionner, diviser, faire pivoter ou réorganiser des documents sur des ordinateurs modestes.

Une fois le serveur installé, vous pourrez Fusionnez plusieurs fichiers PDF avec Stirling PDF, supprimer des pages, réorganiser des documents ou Convertir plusieurs images en un seul PDF.

Configuration requise pour installer Stirling PDF avec Docker

Pour un déploiement de base, vous avez besoin de :

• Docker Engine 20.10 ou version ultérieure.
• Docker Compose installé.
• Un minimum de 2 Go de RAM.
• Au moins 5 Go d'espace de stockage sont nécessaires pour un test de base.
• Un dossier où les paramètres persistants peuvent être stockés.
• Accès à un terminal ou à une interface compatible Compose.

Pour un serveur utilisé régulièrement, les recommandations suivantes s'appliquent : 2 cœurs de processeur, 4 Go de RAM et 10 Go d'espace libreLes conversions, le rendu et la reconnaissance optique de caractères (OCR) peuvent nécessiter plusieurs fois la taille du document en mémoire.

Vérifiez l'installation :

docker --version
docker compose version

Dans les systèmes actuels, il est préférable d'utiliser docker composeavec un espace. Certaines interfaces et versions plus anciennes continuent de s'afficher. docker-composeCependant, les deux commandes ne sont pas toujours disponibles simultanément.

Installation rapide avec Docker Run

Pour essayer Stirling PDF sans créer de fichier Compose, exécutez :

docker run -d \
  --name stirling-pdf \
  -p 8080:8080 \
  -v ./stirling-data:/configs \
  docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

Ouvrez ensuite :

http://localhost:8080

Si Docker est exécuté sur une autre machine, remplacez-le. localhost par leur adresse IP :

http://192.168.1.50:8080

Le volume ./stirling-data:/configs Il conserve les paramètres et la base de données lorsque le conteneur est supprimé ou mis à jour.

Cette méthode convient pour un test rapide. Pour une installation permanente, Docker Compose est plus pratique, car il documente les ports, les volumes, les variables et les règles de redémarrage.

Comment préparer des dossiers persistants

Créez un dossier pour le projet et plusieurs répertoires persistants :

mkdir -p ~/stirling-pdf/stirling-data/{configs,logs,pipeline,tessdata}
cd ~/stirling-pdf

Chaque répertoire remplit une fonction différente :

• configs: paramètres et base de données interne.
• logs: journaux d'opérations et d'erreurs.
• pipeline: configurations pour le traitement automatisé.
• tessdata: modèles linguistiques utilisés par Tesseract.

Vous pouvez également créer un volume pour /customFiles Si vous avez besoin de polices, de thèmes, de signatures ou d'autres fichiers personnalisés.

Aucune configuration requise PUID y PGID Dans toutes les installations. Certains modèles communautaires pour NAS ou Unraid utilisent ces variables, mais la configuration officielle de base repose sur les permissions des dossiers montés.

Comment installer Stirling PDF avec Docker Compose

Dans ~/stirling-pdf, crée un fichier appelé docker-compose.yml avec ce contenu :

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/pipeline:/pipeline
      - ./stirling-data/tessdata:/usr/share/tessdata
    environment:
      SECURITY_ENABLELOGIN: "true"
      SECURITY_INITIALLOGIN_USERNAME: "admin"
      SECURITY_INITIALLOGIN_PASSWORD: "${STIRLING_ADMIN_PASSWORD}"
      SYSTEM_DEFAULTLOCALE: "es-ES"
    restart: unless-stopped

Il crée également un fichier .env dans le même dossier :

STIRLING_ADMIN_PASSWORD=INTRODUCE_UNA_CONTRASEÑA_SEGURA

Protégez le fichier afin que seul votre utilisateur puisse le lire :

chmod 600 .env

Le service commence alors :

docker compose up -d

Vérifiez son statut :

docker compose ps

Le conteneur devrait apparaître comme démarré. Lors du premier démarrage, la préparation de la base de données et des composants internes peut prendre quelques secondes.

Comment configurer la langue et l'authentification

Les images Docker actuelles contiennent Connexion activée par défautSi vous ne définissez pas d'identifiants initiaux, un compte sera créé avec :

• Utilisateur: admin
• Mot de passe: stirling

Vous devez modifier ce mot de passe immédiatement. La configuration précédente empêche son utilisation en vous obligeant à définir votre propre mot de passe dès le premier déploiement.

Les variables SECURITY_INITIALLOGIN_USERNAME y SECURITY_INITIALLOGIN_PASSWORD Ces identifiants servent lors de la création du compte initial. Ils ne peuvent pas être utilisés ultérieurement pour modifier le mot de passe d'un utilisateur existant ; cette modification doit être effectuée via l'interface.

Si le serveur est totalement isolé et que vous souhaitez l'utiliser sans authentification, vous pouvez spécifier :

SECURITY_ENABLELOGIN: "false"

Ne désactivez pas l'authentification si d'autres utilisateurs peuvent accéder au port, si vous utilisez un réseau partagé ou si vous prévoyez de publier le service sur Internet.

Pour utiliser l'espagnol comme langue par défaut, la variable actuelle est :

SYSTEM_DEFAULTLOCALE: "es-ES"

Si aucune langue n'est définie, Stirling PDF tente de détecter la langue du navigateur. Pour limiter les langues disponibles dans le sélecteur, vous pouvez utiliser UI_LANGUAGES, dont les codes utilisent des traits de soulignement :

UI_LANGUAGES: "es_ES,en_US"

Comment ajouter la reconnaissance optique de caractères (OCR) en espagnol

Stirling PDF utilise Tesseract pour reconnaître le texte dans les documents numérisés. La reconnaissance optique de caractères (OCR) extrait le texte, mais Il ne reconstruit pas automatiquement les tableaux, les formules ou les structures complexes..

Pour reconnaître les documents en espagnol, téléchargez le fichier spa.traineddata Téléchargez-le depuis les dépôts officiels de Tesseract et enregistrez-le sous :

~/stirling-pdf/stirling-data/tessdata

Le dossier est connecté à /usr/share/tessdata à l'intérieur du conteneur en utilisant le fichier Compose.

Ne pas supprimer eng.traineddataStirling PDF doit conserver le modèle anglais même si vous ajoutez d'autres langues.

Vous pouvez choisir entre :

• tessdata_fast : Des fichiers plus petits et plus rapides, mais potentiellement moins précis.
• tessdata : Des modèles plus lourds qui peuvent offrir de meilleurs résultats.

Après avoir ajouté le fichier, redémarrez le conteneur :

docker compose restart stirling-pdf

La reconnaissance optique de caractères (OCR) vous permet de convertir un document numérisé en un PDF consultable. Si vous devez modifier le contenu ultérieurement, vous pouvez… Convertissez des PDF en Word avec Stirling PDFSachant que la fidélité dépendra du design original.

Comment y accéder depuis d'autres appareils du réseau

Trouvez l'adresse IP de la machine exécutant Docker et ouvrez-la depuis un autre appareil :

http://DIRECCION_IP:8080

Par exemple:

http://192.168.1.50:8080

Si la page ne se charge pas, vérifiez que le pare-feu autorise les connexions TCP au port 8080 depuis le réseau local.

Il n'est pas nécessaire d'ouvrir le port sur votre routeur pour l'utiliser à domicile ou au bureau. Le fait de le limiter à votre réseau local réduit la surface d'attaque.

Depuis l'interface, vous pouvez effectuer des opérations telles que : supprimer les pages blanches et modifier les documents, ajouter des annotations ou ajouter un filigrane à un PDF.

Comment accéder à distance et en toute sécurité

N’exposez pas directement le port 8080 sur Internet via la redirection de ports de votre routeur. La connexion utiliserait le protocole HTTP et pourrait être accessible à des traqueurs ou des attaquants.

Les alternatives les plus sûres sont :

• Accès via un VPN privé comme WireGuard ou Tailscale.
• Utilisez un proxy inverse avec un domaine et un certificat HTTPS.
• Configurez un tunnel authentifié en tant que tunnel Cloudflare.

Nginx, Caddy ou Traefik peuvent servir de proxy inverse et envoyer des requêtes HTTPS au conteneur en utilisant http://localhost:8080Le certificat peut être géré avec Let's Encrypt ou avec le fournisseur de domaine.

L'authentification Stirling PDF doit rester activée même si le proxy protège déjà la connexion. Le chiffrement HTTPS sécurise le transport, tandis que l'authentification contrôle qui peut utiliser l'application.

Comment installer Stirling PDF sur un Raspberry Pi ou un NAS

Sur un Raspberry Pi aux ressources limitées, vous pouvez modifier l'image comme suit :

docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest-ultra-lite

Les opérations simples devraient fonctionner correctement, mais la reconnaissance optique de caractères (OCR), les conversions Office et le traitement de documents volumineux peuvent être lents ou dépasser la mémoire disponible.

Sur les NAS Synology, QNAP et autres périphériques NAS compatibles, vous pouvez déployer le même fichier à l'aide de Docker Compose, Container Manager ou Portainer. Dans Portainer, ouvrez Piles > Ajouter une pileCollez la configuration et ajustez les chemins d'accès pour qu'ils pointent vers des dossiers partagés permanents.

Vérifiez les autorisations d'écriture sur configs, logs, pipeline y tessdataUtiliser PUID y PGID uniquement lorsque le modèle NAS spécifique le permet.

Comment ajuster les performances

L'installation d'un petit équipement peut commencer par 2 cœurs, 4 Go de RAM et 10 Go d'espace libreLes documents comportant de nombreuses pages, des polices intégrées ou des graphiques vectoriels peuvent prendre beaucoup plus de place lors du traitement.

Les opérations les plus exigeantes sont généralement :

• OCR utilisant Tesseract ou OCRmyPDF.
• Conversion de documents avec LibreOffice.
• Conversion de PDF en images.
• Compression et réparation des fichiers volumineux.

N’augmentez pas les limites du nombre de processus simultanés sans surveiller la mémoire. Sur les serveurs aux performances modestes, il est préférable de traiter les documents en file d’attente plutôt que de provoquer une erreur due à une mémoire vive insuffisante.

Si le serveur dessert plusieurs utilisateurs, vérifiez son utilisation à l'aide de :

docker stats stirling-pdf

Comment mettre à jour un PDF Stirling sans perdre de données

Avant la mise à jour, créez une copie des dossiers persistants, du fichier Compose et du fichier .env:

tar -czf stirling-backup.tar.gz \
  stirling-data docker-compose.yml .env

Enregistrez une copie sur un autre appareil ou système de stockage. Le fichier .env Il contient le mot de passe initial et doit rester protégé.

Mettez ensuite l'image à jour :

docker compose down
docker compose pull
docker compose up -d

Les données restent dans les dossiers montés. Sur un serveur critique, il est conseillé de les remplacer. latest par une version spécifique pour contrôler quand les modifications sont appliquées.

Erreurs courantes lors de l'installation de Stirling PDF avec Docker

Docker ne trouve pas l'image frooodle/s-pdf

Les anciens guides étaient utilisés frooodle/s-pdfRemplacez cette référence par :

docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

Si le registre principal ne répond pas, vous pouvez également utiliser :

ghcr.io/stirling-tools/stirling-pdf:latest

Le port 8080 est déjà occupé

Modifiez uniquement le port sur l'ordinateur hôte :

ports:
  - "9000:8080"

Ensuite, accédez via http://localhost:9000.

Le conteneur redémarre sans cesse.

Vérifiez les dossiers :

docker logs stirling-pdf

Vérifiez l'espace disponible, la mémoire et les autorisations d'écriture sur les volumes. Sur les systèmes aux ressources limitées, testez l'image. latest-ultra-lite.

Les paramètres disparaissent après la mise à jour

Le volume /configs Le montage est incorrect ou le dossier dans lequel il pointe est différent. Vérifiez le chemin d'accès. docker-compose.yml et que l'utilisateur du conteneur peut y écrire.

L'interface n'apparaît pas en espagnol.

Utiliser SYSTEM_DEFAULTLOCALE=es-ESL'ancienne variable LANGS=es_ES Cela ne définit pas la langue par défaut dans la configuration actuelle.

La reconnaissance optique de caractères (OCR) n'affiche pas l'espagnol

Vérifiez cela spa.traineddata existe dans le dossier monté et le volume pointe vers /usr/share/tessdataIl préserve également eng.traineddata.

Je ne peux pas me connecter

Sur une nouvelle installation sans identifiants personnalisés, testez admin y stirling et modifiez immédiatement le mot de passe. Si la base de données existait déjà, les variables de démarrage initiales ne remplaceront pas les identifiants enregistrés.

Autorisation refusée lors de l'utilisation d'un volume

Créez les dossiers avant de démarrer le conteneur et vérifiez leur propriétaire et leurs permissions. N'appliquez pas de permissions d'écriture globales sans discernement et ne configurez pas les dossiers. 777 comme solution permanente.

L'application fonctionne en local, mais pas depuis un autre ordinateur.

Vérifiez que vous utilisez bien l'adresse IP du serveur, que le port est ouvert et que le pare-feu autorise les connexions depuis le réseau local. localhost Cela fait toujours référence à l'appareil à partir duquel vous ouvrez le navigateur.

Le serveur manque de mémoire avec les fichiers volumineux.

Réduisez le nombre d'opérations simultanées ; utilisez la version Ultra-Lite si vous n'avez pas besoin d'outils avancés, ou augmentez votre mémoire vive. La reconnaissance optique de caractères et le rendu peuvent consommer plusieurs fois la taille du fichier d'origine.

L'installation de Stirling PDF avec Docker permet de proposer une plateforme de gestion documentaire centralisée à tous les appareils du réseau. L'image standard convient à la plupart des utilisateurs, tandis que les versions Fat et Ultra-Lite permettent de privilégier la compatibilité ou la réduction de la consommation de ressources.

L'étape cruciale consiste à monter correctement les volumes, à maintenir l'authentification, à configurer l'OCR uniquement lorsque cela est nécessaire et à protéger tout accès distant par un VPN ou HTTPS. Il est également indispensable de sauvegarder vos données. /configs avant la mise à jour, car elle contient les paramètres d'installation et la base de données.