AssAI ← Retour au site AssAI

← 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

Avant de commencer
Les étapes
  1. Vérifier le NAS
  2. Installer Container Manager
  3. Créer le dossier AssAI
  4. Préparer le NAS (une tâche)
  5. Coller le projet AssAI
  6. Premier lancement d'AssAI
  7. Paheko (compta)
  8. Le VPN, pour l'extérieur
  9. Téléphone et ordinateur
  10. Mettre à jour, sauvegarder
  11. Si ça bloque

1Vérifier le NAS

  1. Ouvrez DSM (la page de votre NAS) dans le navigateur et connectez-vous avec le compte administrateur.
  2. 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.
  3. Panneau de configuration › Mise à jour et restauration : installez la dernière version de DSM.
  4. 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

  1. Ouvrez le Centre de paquets.
  2. Cherchez Container Manager, puis Installer. Choisissez le volume 1 si on vous le demande.
  3. 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.

  1. Panneau de configuration › Dossier partagé › Créer.
  2. Nom : AssAI (exactement, avec les majuscules). Emplacement : volume 1.
  3. 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.

  1. Panneau de configuration › Planificateur de tâches › Créer › Tâche déclenchée › Script défini par l'utilisateur.
  2. Onglet Général : nom preparer-assai ; utilisateur root ; décochez « Activé ».
  3. 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
  4. 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.
  5. OK. DSM peut vous avertir sur l'utilisateur root : acceptez, c'est normal pour cette tâche.
  6. Sélectionnez la tâche, puis Exécuter. Attendez 10 secondes.
  7. Ouvrez File Station › docker › assai › preparation.txt (double-clic). Vous devez y lire :
    • Login Succeeded
    • Dossier Paheko : OK
    • Dossier partagé AssAI : OK
    Une ligne « WARNING » peut aussi s'afficher : ce n'est pas grave.
  8. Supprimez la tâche preparer-assai (elle contient votre jeton). Votre NAS, lui, reste connecté : les mises à jour marcheront.
Si vous lisez 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

  1. Ouvrez Container Manager › Projet › Créer.
  2. Nom du projet : assai (en minuscules : Container Manager refuse les majuscules).
  3. Chemin : Définir le chemin › docker › assai (le dossier créé par la tâche).
  4. 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:
  1. Suivant. Ne cochez pas le « portail web » (Web Station). Suivant, puis Terminé.
  2. 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 »).
Jamais de port ouvert dans la box pour 8100 (AssAI) ni 8080 (Paheko). Ils restent dans la maison. Pour l'extérieur, on utilise le VPN (étape 8).

6Premier lancement d'AssAI

  1. Sur un ordinateur de la maison, ouvrez http://ADRESSE-DU-NAS:8100 (par exemple http://192.168.1.50:8100).
  2. AssAI vous guide en 5 étapes, avec le bouton Suivant :
    1. 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.
    2. Votre équipe : le nom de votre structure.
    3. L'IA : choisissez une IA et collez sa clé, puis Tester la clé. Pas encore de clé ? Passer : AssAI marche aussi sans IA.
    4. Paheko : Passer pour l'instant (on le relie à l'étape 7).
    5. C'est prêt : vérifiez le résumé, puis Installer.
  3. 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.
  4. 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.
C'est bon si : la page d'AssAI s'ouvre, avec ses onglets, et l'état dans ⚙️ Réglages est vert (ou rouge seulement pour l'IA si vous n'avez pas mis de clé).

7Paheko (si vous avez pris le choix A)

  1. Ouvrez http://ADRESSE-DU-NAS:8080. Paheko vous demande de créer votre organisation (nom de votre structure) et votre compte administrateur Paheko.
  2. Dans Paheko : Configuration › Extensions › activez Devis et factures.
  3. 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.
  4. 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.

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.

  1. Une adresse qui ne change pas : Panneau de configuration › Accès externe › DDNS › Ajouter, fournisseur Synology, choisissez un nom (par exemple votrenom.synology.me).
  2. Centre de paquets › installez VPN Server.
  3. 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.
  4. Exporter la configuration : vous obtenez un fichier .zip. Dedans, le fichier .ovpn : ouvrez-le avec le Bloc-notes et remplacez YOUR_SERVER_IP par votre adresse DDNS. Enregistrez.
  5. Dans la box : ouvrez (« redirigez ») seulement le port UDP 1194 vers ADRESSE-DU-NAS. Rien d'autre.
  6. Sur le téléphone et l'ordinateur : installez l'appli OpenVPN Connect, importez le fichier .ovpn, connectez-vous avec un compte du NAS.
C'est bon si : en 4G (Wi-Fi coupé), VPN allumé, 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

10Mettre à jour, sauvegarder

Mettre à jour AssAI et Paheko

  1. Container Manager › Projet › assai › Arrêter.
  2. Action › Construire : le NAS télécharge la nouvelle version.
  3. Démarrer. Vos données sont gardées.
  4. 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é.

La clé de chiffrement : AssAI chiffre les mots de passe qu'il garde (IA, Paheko, mail…). Sa clé est rangée à part (volume Docker assai-cle), exprès pas dans la sauvegarde : une sauvegarde volée ne donne pas vos mots de passe. Si vous réinstallez sur un autre NAS, AssAI marche avec vos données, mais il faudra retaper les mots de passe des services dans ⚙️ Réglages. En supprimant le projet, ne cochez pas « supprimer les volumes ».

11Si ça bloque

Ce que vous voyezQue faire
pull access denied ou unauthorized en créant le projetLe 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 errorLe 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 pasLe projet est-il vert dans Container Manager ? Bonne adresse ? Bien http (pas https) ? Dehors : le VPN est-il allumé ?
AssAI ne trouve pas PahekoDans ⚙️ 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.
Toujours bloqué ? Écrivez au Support : l'étape, ce que vous voyez, une capture d'écran sans mot de passe, sans jeton et sans adresse. Dans AssAI, ⚙️ Réglages permet aussi d'ouvrir un accès Support temporaire.