Ressources · Intégration n8n

Nœud Local File Trigger n8nConfigurer Local File Trigger dans n8n.

Un fichier bouge sur le disque, le workflow démarre. Le nœud Local File Trigger n8n surveille un fichier précis ou un dossier entier, réagit aux ajouts, modifications et suppressions, et propose 8 paramètres pour filtrer le bruit. Pour les équipes dont la matière première reste des fichiers.

Tester le nœud Local File Trigger sur n8nVoir les 8 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Local File Trigger n8n ?

Local File Trigger est un trigger, c'est-à-dire un nœud qui ouvre le workflow au lieu de s'insérer au milieu. Il écoute le système de fichiers de la machine qui fait tourner n8n et lance une exécution dès qu'un fichier ou un dossier est ajouté, modifié ou supprimé. Aucun compte à relier, aucune URL à enregistrer : tu donnes un chemin, tu coches les événements, et le workflow part tout seul.

Premier scénario, un fichier de configuration qui ne doit pas changer dans le dos de l'équipe. Trigger On passe sur Changes to a Specific File, Watch for ne garde que File Changed, et l'alerte tombe dans un canal Slack. Chaque modification laisse une trace, y compris celles faites directement sur le serveur.

Deuxième scénario, un dossier d'export qui se remplit toute la journée. Là, le vrai problème c'est le bruit : Ignore écarte les fichiers temporaires, Ignore Existing Files/Folders évite que l'historique se déclenche à la première activation, et un nœud If trie ce qui reste selon l'extension.

Troisième scénario, le dossier de comptabilité. Un prestataire dépose sa facture en PDF, le nœud se déclenche sur File Added, la suite du workflow renomme le document et ajoute une ligne dans Google Sheets. Plus personne ne fait la reprise manuelle en fin de mois.

Quand prendre autre chose ? Ce nœud ne voit que ce que voit la machine n8n. Un document exposé derrière une API n'est pas un événement de système de fichiers : un nœud dédié s'en charge, ou HTTP Request quand aucun nœud dédié ne couvre l'appel. HTTP Request reste le recours pour un endpoint HTTP, jamais pour un protocole qui n'est pas HTTP.

Les limites à connaître avant de construire. La doc officielle signale un risque de sécurité sur les instances ouvertes à des utilisateurs non fiables : le nœud est désactivé par défaut à partir de n8n 2.0 et décrit comme réservé à l'auto-hébergement. La version maximale du nœud est la version 1, donc un ancien workflow affiche le même panneau. Sur un partage réseau, Use Polling devient souvent obligatoire, et les motifs regex de Ignore peuvent ne pas fonctionner sur macOS. Pour choisir la plateforme elle-même, l'Avis n8n détaille les arbitrages.

Paramètres

Comment régler chaque paramètre ?

Le nœud Local File Trigger compte 8 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Trigger On

triggerOn

Ce que tu vois dans n8n

Notes & cas d'usage

Ce sélecteur requis décide de toute la forme du nœud : un fichier sous surveillance, ou un dossier et tout ce qui s'y passe. On le règle en premier, parce que les champs suivants dépendent de la réponse.

Paramètres clés

  • Trigger On : file (Changes to a Specific File) ou folder (Changes Involving a Specific Folder).
  • File to Watch : le chemin à suivre, sur le modèle de /data/invoices/1.pdf.
  • Watch for : la liste requise des événements à cocher, add (File Added), change (File Changed), unlink (File Deleted), addDir (Folder Added), unlinkDir (Folder Deleted).
Cas d'usage
un dossier surveillé sur File Added seulement, pour qu'un dépôt de factures lance une exécution par nouveau document et ignore les retouches qui suivent.
02

Await Write Finish

options.awaitWriteFinish

Ce que tu vois dans n8n

Notes & cas d'usage

Un gros fichier n'arrive pas d'un bloc. Activée, cette option demande à n8n d'attendre la fin de l'écriture avant de lancer l'exécution, ce qui évite de lire un document à moitié copié.

Paramètres clés

  • Await Write Finish : une case à cocher, ajoutée via Add option dans la collection Options comme toutes les options de ce nœud.
Cas d'usage
un scanner qui écrit un PDF lourd directement dans le dossier surveillé. Sans l'attente, le nœud suivant ouvre parfois un fichier tronqué et l'exécution échoue pour une raison qui semble aléatoire.
04

Ignore

options.ignored

Ce que tu vois dans n8n

Notes & cas d'usage

Le filtre de tout ce qui ne doit pas réveiller le workflow. n8n teste le chemin complet, pas seulement le nom du fichier, et le champ accepte la syntaxe Anymatch, du type **/*.txt or ignore-me/subfolder.

Paramètres clés

  • Ignore : les fichiers ou chemins à écarter. Les motifs regex peuvent ne pas fonctionner sur macOS, et la correspondance par sous-chaîne passe par l'option Ignore Mode réglée sur Contain.
Cas d'usage
un dossier d'export où l'outil écrit un fichier temporaire avant de le renommer. Écarter ce motif supprime les exécutions en double sans toucher au reste du réglage.
05

Ignore Existing Files/Folders

options.ignoreInitial

Ce que tu vois dans n8n

Notes & cas d'usage

Au démarrage de l'écoute, tout ce qui traîne déjà dans le dossier peut compter comme un événement à signaler. Cette option dit à n8n de laisser cet existant tranquille et de ne réagir qu'à la suite.

Paramètres clés

  • Ignore Existing Files/Folders : une case à cocher qui empêche les fichiers et dossiers déjà présents de déclencher un événement.
Cas d'usage
l'activation d'un workflow sur un répertoire d'archives bien rempli. Sans elle, la première activation noie la liste des exécutions et les vrais événements deviennent introuvables.
06

Max Folder Depth

options.depth

Ce que tu vois dans n8n

Notes & cas d'usage

En mode dossier, la surveillance peut descendre aussi loin que l'arborescence le permet. Ce sélecteur pose la limite, pour qu'un dossier partagé ne soit pas suivi branche par branche sans que personne l'ait demandé.

Paramètres clés

  • Max Folder Depth : 0 (Top Folder Only), de 1 à 5 (1 Levels Down à 5 Levels Down), ou -1 (Unlimited).
Cas d'usage
un répertoire clients avec un sous-dossier par compte. Top Folder Only attrape les nouveaux comptes, 1 Levels Down attrape aussi les documents rangés dedans.
07

Use Polling

options.usePolling

Ce que tu vois dans n8n

Notes & cas d'usage

La surveillance est normalement assurée par le système de fichiers lui-même. Sur un réseau, il ne remonte souvent rien : cette option bascule le nœud en polling, c'est-à-dire une vérification régulière du chemin au lieu d'une notification attendue.

Paramètres clés

  • Use Polling : une case à cocher, en général nécessaire pour surveiller des fichiers à travers le réseau.
Cas d'usage
un dossier monté depuis un NAS. Les événements arrivent bien en test local puis disparaissent une fois le même chemin monté en réseau, et c'est ce réglage qui remet tout en route.
08

Ignore Mode

options.ignoreMode

Ce que tu vois dans n8n

Notes & cas d'usage

Ce sélecteur décide de la lecture de la valeur d'Ignore : un motif à faire correspondre, ou un bout de texte à retrouver dans le chemin. C'est l'option compagne qu'on oublie quand un filtre n'attrape rien.

Paramètres clés

  • Ignore Mode : match (Match) pour les motifs regex comme **/*.txt, non pris en charge sur macOS, ou contain (Contain) pour ignorer les fichiers dont le chemin contient la valeur.
Cas d'usage
une équipe sous macOS qui veut écarter tout ce qui est rangé dans un répertoire de brouillons. Contain avec un simple mot fait le travail là où un motif échoue.
Besoin d'aide

Besoin d'aide pour automatiser Local File Trigger avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Local File Trigger et n8n, les questions fréquentes

01Le nœud Local File Trigger n8n est-il inclus dans n8n ?
Oui. C'est un nœud core, livré avec n8n : rien à installer, aucun coût supplémentaire côté n8n. Un détail compte avant de construire dessus : la doc officielle précise que ce nœud n'est pas disponible sur n8n Cloud, et qu'il est désactivé par défaut à partir de n8n 2.0, parce que surveiller un système de fichiers devient risqué sur une instance ouverte à des utilisateurs non fiables. En pratique, il tourne sur une instance auto-hébergée, montée avec Docker ou avec npm. Le workflow que tu construis là reste un workflow n8n classique, c'est l'accès aux fichiers qui change.
02Quels credentials faut-il pour Local File Trigger ?
Aucun. Ce nœud n'a ni credential, c'est-à-dire aucun identifiant enregistré dans n8n, ni sélecteur Authentication : rien à configurer côté compte, rien à renouveler plus tard. Ce qu'il lui faut, c'est un accès. Le chemin saisi doit être visible par la machine qui exécute n8n, donc un volume monté dans le conteneur plutôt qu'un dossier qui n'existe que sur ton poste. L'autre condition tient à l'état du workflow : dans l'éditeur, l'exécution de test lance une écoute ponctuelle pour vérifier le réglage, et en production le workflow doit être actif pour que le nœud continue d'écouter.
03Quelles sont les limites du nœud Local File Trigger ?
La première tient au périmètre : le nœud ne voit que le système de fichiers de sa propre machine, rien d'autre. La version maximale au catalogue est la version 1, il n'y a donc pas de panneau plus récent avec des options en plus. Les partages réseau sont le deuxième piège, puisque les événements se perdent souvent à travers un montage : Use Polling est la réponse documentée. Sur macOS, les motifs regex d'Ignore peuvent ne pas fonctionner, ce qui pousse vers Ignore Mode en Contain. Ajoute la contrainte d'hébergement de la doc, auto-hébergement seulement et désactivation par défaut à partir de n8n 2.0.
04Quand choisir ce nœud plutôt que HTTP Request ?
Local File Trigger dès que l'événement est un fichier qui apparaît, change ou disparaît sur un disque accessible à la machine n8n. HTTP Request quand la donnée vit derrière un endpoint HTTP et qu'aucun nœud dédié ne couvre l'appel voulu. Les deux ne se remplacent pas : HTTP Request est le recours pour une API HTTP, jamais un moyen d'atteindre un protocole qui n'est pas HTTP. Le test est simple. Si tu retrouverais le fichier avec un explorateur sur le serveur, ce nœud est la bonne porte d'entrée. Si tu le retrouverais avec une URL, non.
05n8n ou Make pour surveiller des fichiers ?
Tout dépend de l'endroit où vivent les fichiers. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement et facturée à l'opération : un dossier posé sur ton propre serveur n'est pas quelque chose qu'elle peut surveiller directement. n8n tourne sur ton infrastructure quand tu le décides, ce que ce nœud suppose de toute façon, et un dossier très actif ne se transforme pas en facture au compteur. Make garde ses atouts, à commencer par une logique visuelle que beaucoup d'équipes lisent vite. Si les documents ne sortent pas du réseau, l'auto-hébergement reste le choix cohérent.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations