← Retour au site AssAI · Guide d'installation · Tous les guides · Guide Proton Mail Bridge
Installer Paheko sur un NAS
Paheko, le logiciel de compta de votre équipe, pour qu'AssAI y saisisse les factures · version 0.4 · 17 novembre 2026
Avant de commencer
- Paheko tourne dans un conteneur Docker sur le NAS, comme AssAI. Il faut Container Manager (Synology) ou l'équivalent.
- Paheko reste dans le NAS. Son port n'est jamais ouvert sur la box : on y accède à la maison ou par le VPN du NAS.
- Les mots de passe (Paheko, API, Bridge) ne vont jamais dans un message, un mail ou une photo.
- La version doit être la même partout : la même image dans le Dockerfile et dans le projet. Pour la mettre à jour, on change le numéro aux deux endroits (voir la partie 5).
Pas de NAS ? Paheko existe aussi en ligne, chez un hébergeur. Par exemple paheko.cloud : essai gratuit et illimité (un seul exercice, 10 Mo de documents, pas d'envoi de mails), puis 5 € par an pour l'hébergement, plus un don à prix libre, avec 500 Mo de documents par an, membres et exercices illimités, sauvegardes automatiques. Le logiciel est libre : la partie 1 à 3 de ce guide ne sert alors pas, mais l'accès API (partie 3) reste nécessaire pour AssAI. Le nom de domaine n'est pas compris.
1 · Préparer les dossiers (testé)
- Créer un dossier pour Paheko, par exemple paheko, avec un sous-dossier data pour ses données (la base et les fichiers de votre équipe).
- Y mettre le fichier Dockerfile. Il part de l'image officielle de Paheko et ajoute Ghostscript, nécessaire à l'extension « Devis et factures » pour fabriquer les PDF Factur-X joints aux mails.
- Créer le dossier php avec le fichier short-tag.ini, qui contient une seule ligne :
short_open_tag = Off. Sans lui, le Factur-X plante.
2 · Créer le projet Docker (testé)
- Dans Container Manager, créer un projet nommé paheko, en pointant sur ce dossier.
- Dans le fichier YAML du projet : l'image est construite à partir du Dockerfile (nom du type
paheko-local:1.3.24), le dossier data est rangé dans le conteneur, et le fichier short-tag.ini est monté dans le dossier de configuration de PHP.
- Construire le projet, puis le démarrer.
- Vérifier le port : il ne doit être accessible que sur l'adresse du NAS dans la maison. Ne rien ouvrir sur la box.
- Ouvrir Paheko dans le navigateur (adresse du NAS, port choisi) et créer le compte administrateur, puis l'organisation (nom de votre équipe).
Container Manager garde sa propre copie du YAML. Une modification du fichier sur le NAS n'est prise en compte qu'après l'avoir changée dans l'onglet Configurations YAML du projet.
3 · Réglages dans Paheko (testé)
- Installer l'extension Devis et factures (menu Configuration › Extensions).
- Configuration › Fonctions avancées › API : créer un accès « Peut lire et modifier ». Ne jamais choisir Administration pour AssAI.
- Noter l'identifiant et le mot de passe de cet accès : ils se recopient dans AssAI (⚙️ Réglages › Paheko). Ce sont des accès API, pas des comptes de membres.
- Créer le compte banque (512A) et le compte caisse (530) dans le plan comptable, s'ils n'y sont pas.
4 · Envoi des mails de Paheko (testé)
Paheko envoie les devis et factures par file d'attente. Pour que les mails partent, il faut deux choses :
- Le serveur d'envoi : dans le fichier de configuration local de Paheko (monté à part), régler le SMTP sur Proton Mail Bridge du NAS (adresse du NAS, port 1025, sans chiffrement). Voir le guide Proton Mail Bridge. Après une modification de ce fichier : Arrêter puis Démarrer le projet.
- La tâche planifiée : dans DSM, Panneau de configuration › Planificateur de tâches, créer une tâche toutes les 5 minutes, en utilisateur root. Elle lance la commande vide la file d'attente (elle ne fait rien s'il n'y a rien à envoyer). La commande est dans le fichier envoyer-mails.sh du projet.
C'est bon si : un devis envoyé depuis Paheko arrive dans la boîte d'envoi de Proton, dans les 5 minutes.
5 · Mettre Paheko à jour (testé)
- Faire d'abord une sauvegarde du dossier data (voir le guide d'utilisation, partie Sauvegarde).
- Dans le Dockerfile, changer le numéro de l'image officielle (
paheko/paheko:…).
- Dans le projet, changer le numéro de l'image construite (
paheko-local:…) au même numéro.
- Construire, puis Démarrer. Paheko met sa base à jour au premier lancement.
Ne pas sauter une version majeure sans lire les notes de Paheko. En cas de doute, demander avant de mettre à jour.
6 · Problèmes fréquents
- Une facture en PDF ne se crée pas : vérifier que Ghostscript est bien dans l'image (Construire après le Dockerfile) et que le fichier short-tag.ini est monté.
- Les mails restent en attente : vérifier la tâche planifiée toutes les 5 minutes, et que Proton Bridge tourne. Si la file est bloquée, voir la partie Dépannage de Paheko.
- AssAI dit « 403 Invalid username or password » : l'identifiant ou le mot de passe de l'accès API ne correspondent pas. Refaire l'accès dans Fonctions avancées › API et recopier.
- Après un changement de fichier de configuration, rien ne change : Arrêter puis Démarrer le projet (un simple rechargement ne suffit pas).
- On veut ouvrir Paheko sur Internet : non. Passer par le VPN du NAS si on est à l'extérieur.