Je pars du principe que vous maîtrisez un minimum Docker (avec Portainer) 😉
¶ 1. Stirling PDF, c’est quoi ?
Stirling PDF est une boîte à outils pour fichiers PDF permettant de fusionner, diviser, convertir et plus encore. L’application met l’accent sur la sécurité et la confidentialité : elle ne conserve aucun fichier, suivi ou donnée, et fonctionne entièrement sur votre machine locale. L’interface, le nom et la description sont personnalisables.
¶ Liens utiles
¶ 2. Fichier docker-compose.yml de Base
Le fichier Compose de base pour le déploiement de Stirling PDF :
version: '3.3'
services:
stirling-pdf:
image: frooodle/s-pdf:latest
restart: always
ports:
- '8080:8080'
volumes:
- /usr/share/tessdata:/usr/share/tessdata #Required for extra OCR languages
- /configs:/configs
# - /location/of/customFiles:/customFiles/
# - /location/of/logs:/logs/
environment:
- DOCKER_ENABLE_SECURITY=false
- INSTALL_BOOK_AND_ADVANCED_HTML_OPS=false
- LANGS=fr_FR
Fichier compose également disponible sur ByteStash Blabla Linux.
¶ Explications des Volumes
| Volume | Chemin Conteneur | Description |
|---|---|---|
| OCR | /usr/share/tessdata |
Obligatoire pour ajouter des langues supplémentaires pour la reconnaissance de caractères (OCR). |
| Configs | /configs |
Contient le fichier de configuration principal settings.yml. |
¶ 3. Personnalisation et Configuration
La configuration peut se faire soit via des variables d’environnement (qui priment toujours), soit en modifiant le fichier settings.yml situé dans le volume /configs.
¶ Choix de l’Image Docker (Tags)
Plusieurs tags sont disponibles en fonction de la taille et des fonctionnalités souhaitées :
| Tag | Poids (Compressé) | Fonctionnalités | Utilisation |
|---|---|---|---|
latest |
MB | Quasi toutes les fonctionnalités. | Recommandé (celui utilisé dans le Compose). |
latest-ultra-lite |
MB | Moins de fonctionnalités (plus léger). | Idéal si le stockage est une contrainte. |
latest-fat |
MB | Totalité des fonctionnalités. | Si l’espace de stockage n’est pas un problème. |
¶ Configuration de l’Interface (UI)
Vous pouvez personnaliser le nom et la description de l’application en ajoutant des variables d’environnement au service stirling-pdf :
environment:
# ... autres variables ...
- UI_APP_NAME=Blabla Linux Stirling PDF
- UI_HOME_DESCRIPTION=Boîte à outils de gestion PDF libre et open source, auto hébergé par Blabla Linux grâce à Stirling..
- UI_APP_NAVBAR_NAME=Blabla Linux Stirling PDF
(Ces variables remplacent les valeurs null dans la section ui du fichier settings.yml.)
¶ Activation de la Sécurité et de la Connexion
Par défaut, l’application est accessible sans identifiant. Pour activer un écran de connexion (essentiel si exposé sur le web) :
- Variable Compose : Passer la variable d’environnement de
falseàtrue:- DOCKER_ENABLE_SECURITY=true - Fichier
settings.yml: Modifier la lignesecurity.enableLogindefalseàtrue.security: enableLogin: true # set to 'true' to enable login # ... - Identifiants Initiaux : Dé-commenter et personnaliser les lignes suivantes dans
settings.yml(ou utiliser des variables d’environnement) :
Alternative (variables d’environnement) :# settings.yml # initialLogin: username: "admin" # Initial username for the first login password: "stirling" # Initial password for the first login- SECURITY_INITIALLOGIN_USERNAME=admin - SECURITY_INITIALLOGIN_PASSWORD=stirling
¶ Configuration de la Langue (Locale)
Pour passer l’interface en français, modifiez la ligne defaultLocale dans le fichier settings.yml :
system:
defaultLocale: 'fr-FR' # Set the default language (e.g. 'de-DE', 'fr-FR', etc)
¶ Ajout de Langues pour la Reconnaissance OCR
Par défaut, seul l’anglais est géré. Pour ajouter d’autres langues :
- Téléchargez les fichiers de reconnaissance de langue (
.traineddata) nécessaires (fichiers légers ou lourds) depuis la documentation.
Je suis gentil, je vous fournis ces fichiers grâce au cloud Blabla Linux.
- Placez ces fichiers dans le répertoire de votre hôte que vous avez monté sur
/usr/share/tessdata(ici :/usr/share/tessdata).Note : Ne supprimez pas le fichier
eng.traineddata, Stirling PDF en a besoin.
¶ 4. Lancement et Minimum Requis
Une fois configuré, lancez votre pile :
docker compose up -d
¶ Ressources
- Mémoire vive au repos : Minimum 1 Go.
- Mémoire vive en usage : Certaines fonctionnalités gourmandes (extraction d’images, gros fichiers) peuvent faire s’envoler les besoins en RAM. Si les ressources sont insuffisantes, vous aurez un message d’erreur, mais l’application ne « freeze » pas ; il suffit de rafraîchir la page.
Vous accédez à l’interface à l’adresse http://<Votre_IP_Hôte>:8080.
