← Guide d'installation · Tous les guides
Installer AssAI sur un NAS Synology
Pas à pas, pour débutant, sans ligne de commande · version 0.4 BETA · 17 novembre 2026
- Comptez environ 1 heure. Faites les étapes dans l'ordre.
- Il vous faut :
- un NAS Synology avec un processeur Intel ou AMD (voir l'étape 1) ;
- un compte administrateur du NAS ;
- le jeton de lecture reçu de CreaVisual (une longue suite de lettres et de chiffres). Il permet à votre NAS de télécharger AssAI.
- Les mots de passe et le jeton ne vont jamais dans un mail, un message ou une photo. Gardez-les dans un gestionnaire de mots de passe.
- Dans ce guide, ADRESSE-DU-NAS veut dire l'adresse de votre NAS dans la maison, par exemple
192.168.1.50. Vous la trouvez dans DSM › Panneau de configuration › Réseau › Interface réseau.
1Vérifier le NAS
- Ouvrez DSM (la page de votre NAS) dans le navigateur et connectez-vous avec le compte administrateur.
- Panneau de configuration › Centre d'infos : regardez le processeur. Il doit être Intel (Celeron, Pentium, Core…) ou AMD (Ryzen…).
Processeur Realtek ou ARM (souvent les modèles « j » ou « play ») : AssAI ne marche pas encore sur ce NAS. Arrêtez-vous ici et écrivez-nous.
- Panneau de configuration › Mise à jour et restauration : installez la dernière version de DSM.
- Donnez au NAS une adresse fixe : le plus simple est de le faire dans votre box (« réservation d'adresse » ou « bail DHCP fixe » pour le NAS). Notez cette adresse : c'est ADRESSE-DU-NAS.
2Installer Container Manager
- Ouvrez le Centre de paquets.
- Cherchez Container Manager, puis Installer. Choisissez le volume 1 si on vous le demande.
- Container Manager crée tout seul un dossier partagé nommé docker. C'est là qu'AssAI rangera ses données.
3Créer le dossier AssAI
C'est le seul dossier de vos fichiers qu'AssAI pourra voir (factures, courriers…). Le reste du NAS reste fermé pour lui.
- Panneau de configuration › Dossier partagé › Créer.
- Nom :
AssAI(exactement, avec les majuscules). Emplacement : volume 1. - Suivant jusqu'à la fin. Donnez les droits « Lecture / écriture » aux personnes de votre équipe qui doivent voir ces fichiers depuis leur ordinateur.
4Préparer le NAS (une tâche, une seule fois)
Cette tâche fait 3 choses : elle donne le jeton à votre NAS pour télécharger AssAI, elle crée les dossiers de données, et elle réserve celui de Paheko à Paheko seul.
- Panneau de configuration › Planificateur de tâches › Créer › Tâche déclenchée › Script défini par l'utilisateur.
- Onglet Général : nom
preparer-assai; utilisateur root ; décochez « Activé ». - Onglet Paramètres de tâche : dans « Script défini par l'utilisateur », collez ceci :
D=/volume1/docker/assai mkdir -p $D/assai-data $D/paheko-data { date echo "COLLER-ICI-LE-JETON" | /usr/local/bin/docker login -u creavisual --password-stdin /usr/syno/bin/synoacltool -del $D/paheko-data >/dev/null 2>&1 chown -R 33:33 $D/paheko-data && chmod 700 $D/paheko-data && echo "Dossier Paheko : OK" [ -d /volume1/AssAI ] && echo "Dossier partagé AssAI : OK" || echo "ATTENTION : créez le dossier partagé AssAI" } > $D/preparation.txt 2>&1 - Dans ce texte, remplacez seulement le texte
COLLER-ICI-LE-JETON(en rouge) par votre jeton. Gardez les guillemets autour. Ne changez rien d'autre. - OK. DSM peut vous avertir sur l'utilisateur root : acceptez, c'est normal pour cette tâche.
- Sélectionnez la tâche, puis Exécuter. Attendez 10 secondes.
- Ouvrez File Station › docker › assai › preparation.txt (double-clic). Vous devez y lire :
Login SucceededDossier Paheko : OKDossier partagé AssAI : OK
- Supprimez la tâche
preparer-assai(elle contient votre jeton). Votre NAS, lui, reste connecté : les mises à jour marcheront.
unauthorized ou incorrect username or password : le jeton est mal collé. Modifiez la tâche, recollez le jeton, Exécuter, relisez le fichier. Voir aussi Si ça bloque.5Coller le projet AssAI
- Ouvrez Container Manager › Projet › Créer.
- Nom du projet :
assai(en minuscules : Container Manager refuse les majuscules). - Chemin : Définir le chemin › docker › assai (le dossier créé par la tâche).
- Source : Créer docker-compose.yml. Collez un des deux textes ci-dessous :
Choix A · AssAI + Paheko (conseillé)
Paheko est le logiciel de compta. Avec ce choix, il tourne sur votre NAS, à côté d'AssAI.
services:
assai:
image: creavisual/assai:app
container_name: assai
restart: unless-stopped
security_opt:
- no-new-privileges:true
ports:
- "8100:8100"
environment:
- TZ=Europe/Paris
# AssAI ne voit que le dossier partagé AssAI (pas tout le NAS)
- ASSAI_DOSSIER_FIXE=volume1/AssAI
# Code d'installation : AssAI le crée tout seul dans assai-data/code-installation.txt (rien à mettre ici)
volumes:
- ./assai-data:/data
# Clé qui chiffre les mots de passe gardés par AssAI : créée toute seule, hors du dossier du projet
- assai-cle:/cle
- /volume1/AssAI:/nas/volume1/AssAI
paheko:
image: creavisual/assai:paheko-1.3.24
container_name: paheko
restart: unless-stopped
security_opt:
- no-new-privileges:true
# Port pour ouvrir Paheko dans le navigateur (AssAI, lui, passe par http://paheko).
# Jamais ouvert dans la box. Si personne n'ouvre Paheko à la main, ces 2 lignes peuvent être enlevées.
ports:
- "8080:80"
environment:
- TZ=Europe/Paris
volumes:
- ./paheko-data:/var/www/paheko/data
# Dans AssAI › ⚙️ Réglages › Paheko, l'adresse est : http://paheko
volumes:
assai-cle:Choix B · AssAI seul
Si votre compta est déjà ailleurs (par exemple Paheko en ligne), ou si vous n'en voulez pas.
services:
assai:
image: creavisual/assai:app
container_name: assai
restart: unless-stopped
security_opt:
- no-new-privileges:true
ports:
- "8100:8100"
environment:
- TZ=Europe/Paris
- ASSAI_DOSSIER_FIXE=volume1/AssAI
# Code d'installation : AssAI le crée tout seul dans assai-data/code-installation.txt (rien à mettre ici)
volumes:
- ./assai-data:/data
# Clé qui chiffre les mots de passe gardés par AssAI : créée toute seule, hors du dossier du projet
- assai-cle:/cle
- /volume1/AssAI:/nas/volume1/AssAI
volumes:
assai-cle:- Suivant. Ne cochez pas le « portail web » (Web Station). Suivant, puis Terminé.
- Container Manager télécharge AssAI (quelques minutes la 1re fois), puis le démarre. Le projet assai doit passer au vert (« En cours d'exécution »).
6Premier lancement d'AssAI
- Sur un ordinateur de la maison, ouvrez
http://ADRESSE-DU-NAS:8100(par exemplehttp://192.168.1.50:8100). - AssAI vous guide en 5 étapes, avec le bouton Suivant :
- Code d'installation : il protège votre AssAI tant qu'il n'est pas installé (personne d'autre sur le Wi-Fi ne peut le faire à votre place). Ouvrez File Station › docker › assai › assai-data › code-installation.txt et recopiez le code (par exemple
ABCD-2345). Ce fichier s'efface tout seul une fois l'installation faite.
Mot de passe administrateur (2 fois). Choisissez-le long et gardez-le dans votre gestionnaire de mots de passe. - Votre équipe : le nom de votre structure.
- L'IA : choisissez une IA et collez sa clé, puis Tester la clé. Pas encore de clé ? Passer : AssAI marche aussi sans IA.
- Paheko : Passer pour l'instant (on le relie à l'étape 7).
- C'est prêt : vérifiez le résumé, puis Installer.
- Code d'installation : il protège votre AssAI tant qu'il n'est pas installé (personne d'autre sur le Wi-Fi ne peut le faire à votre place). Ouvrez File Station › docker › assai › assai-data › code-installation.txt et recopiez le code (par exemple
- AssAI affiche la clé admin (une longue suite créée par AssAI). Elle ne sera plus jamais affichée : copiez-la dans votre gestionnaire de mots de passe, puis C'est noté, continuer. Elle donne tous les droits : gardez-la pour vous, ne la donnez pas aux membres (on les invite, étape 9).
Ne pas confondre : le mot de passe administrateur, c'est vous qui l'avez choisi (étape 1) ; il ouvre ⚙️ Réglages. La clé admin, c'est AssAI qui la crée ; elle connecte un appareil en administrateur.
- Ensuite, AssAI propose 3 réglages un par un : le stockage, les boîtes mail, la traduction. Vous pouvez faire Plus tard : tout se change dans ⚙️ Réglages.
7Paheko (si vous avez pris le choix A)
- Ouvrez
http://ADRESSE-DU-NAS:8080. Paheko vous demande de créer votre organisation (nom de votre structure) et votre compte administrateur Paheko. - Dans Paheko : Configuration › Extensions › activez Devis et factures.
- Configuration › Fonctions avancées › API : créez un accès « Peut lire et modifier » (jamais « Administration »). Notez l'identifiant et le mot de passe de cet accès.
- Dans AssAI : ⚙️ Réglages › Paheko :
- Adresse :
http://paheko(pas l'adresse du NAS : AssAI et Paheko se parlent directement dans le projet) ; - identifiant et mot de passe de l'accès API ;
- Tester, puis Enregistrer.
- Adresse :
Plus de détails (plan comptable, envoi des mails de Paheko) : guide Paheko.
8Le VPN, pour utiliser AssAI hors de la maison
À la maison, rien à faire. Dehors, votre téléphone ou ordinateur passe par un VPN : un tunnel privé vers votre NAS. C'est le seul port ouvert dans la box.
- Une adresse qui ne change pas : Panneau de configuration › Accès externe › DDNS › Ajouter, fournisseur Synology, choisissez un nom (par exemple votrenom.synology.me).
- Centre de paquets › installez VPN Server.
- VPN Server › OpenVPN : cochez « Activer le serveur OpenVPN », cochez « Autoriser les clients à accéder au LAN du serveur », Appliquer.
Ne pas activer de serveur DHCP sur le NAS : votre box le fait déjà. Deux serveurs DHCP cassent le réseau de la maison.
- Exporter la configuration : vous obtenez un fichier
.zip. Dedans, le fichier.ovpn: ouvrez-le avec le Bloc-notes et remplacezYOUR_SERVER_IPpar votre adresse DDNS. Enregistrez. - Dans la box : ouvrez (« redirigez ») seulement le port UDP 1194 vers ADRESSE-DU-NAS. Rien d'autre.
- Sur le téléphone et l'ordinateur : installez l'appli OpenVPN Connect, importez le fichier
.ovpn, connectez-vous avec un compte du NAS.
http://ADRESSE-DU-NAS:8100 ouvre AssAI.Les noms des boutons de la box changent selon l'opérateur. Cherchez « redirection de ports » ou « NAT/PAT » dans son aide.
9Téléphone et ordinateur
- Navigateur :
http://ADRESSE-DU-NAS:8100marche partout (ajoutez-le aux favoris). - Appli Android et appli Windows : page Télécharger. Au premier lancement, donnez l'adresse
http://ADRESSE-DU-NAS:8100. Vous : la clé admin (étape 6). Les membres : « Se connecter avec mon compte », avec leur invitation. - Inviter votre équipe : dans AssAI, ⚙️ Réglages › Équipe. Chacun a son propre mot de passe et ses droits.
10Mettre à jour, sauvegarder
Mettre à jour AssAI et Paheko
- Container Manager › Projet › assai › Arrêter.
- Action › Construire : le NAS télécharge la nouvelle version.
- Démarrer. Vos données sont gardées.
- Dans le navigateur, rechargez la page avec Ctrl + F5. La version est écrite en haut de la page d'AssAI.
Sauvegarder
Tout ce qui compte est dans 2 dossiers : docker/assai (réglages d'AssAI et compta Paheko) et AssAI (vos fichiers). Avec Hyper Backup (Centre de paquets), sauvegardez ces 2 dossiers chaque nuit, de préférence vers un disque externe ou un stockage en ligne chiffré.
11Si ça bloque
| Ce que vous voyez | Que faire |
|---|---|
pull access denied ou unauthorized en créant le projet | Le NAS n'a pas le jeton. Refaites l'étape 4 (la tâche), vérifiez preparation.txt, puis dans le projet : Action › Construire. |
| « Code d'installation incorrect » | Recopiez le code du fichier code-installation.txt (étape 6), tiret compris ou non. Après 8 essais ratés, attendez 15 minutes. |
| Journal du conteneur assai : « AssAI reste en root » | AssAI marche, mais avec plus de droits que nécessaire. Vérifiez que le dossier partagé AssAI donne « Lecture / écriture » au groupe administrators (Panneau de configuration › Dossier partagé › Modifier › Permissions), puis Arrêter / Démarrer le projet. |
| « Le nom du projet n'est pas valide » | Minuscules seulement, sans espace : assai. |
port is already allocated (port déjà utilisé) | Un autre logiciel du NAS prend déjà 8100 ou 8080. Dans le YAML (Projet › YAML), changez le premier nombre, par exemple "8180:8100" ou "8090:80", puis utilisez ce nouveau nombre dans l'adresse. |
exec format error | Le NAS a un processeur ARM ou Realtek : pas encore pris en charge (étape 1). |
| Paheko affiche une erreur sur le dossier data ou « RuntimeException » | La tâche de l'étape 4 n'a pas donné les droits. Relancez-la (avec le jeton), puis Arrêter / Démarrer le projet. |
La page http://ADRESSE-DU-NAS:8100 ne s'ouvre pas | Le projet est-il vert dans Container Manager ? Bonne adresse ? Bien http (pas https) ? Dehors : le VPN est-il allumé ? |
| AssAI ne trouve pas Paheko | Dans ⚙️ Réglages › Paheko, l'adresse est http://paheko. L'accès API doit être « Peut lire et modifier ». |
| Mot de passe administrateur d'AssAI perdu | Écrivez au Support (ci-dessous). Ne supprimez pas le dossier assai-data. |