Nœud Git n8nConfigurer Git dans n8n.
Le nœud Git n8n exécute des commandes git sur un dépôt posé sur le disque de ton instance. Il embarque 15 opérations, de clone à commit en passant par log, tag et switch branch, toutes accrochées à un chemin de dépôt. Utile dès qu'un workflow produit des fichiers qui méritent un historique.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert vraiment le nœud Git n8n ?
Git fait partie des nœuds core livrés avec n8n : il enveloppe la ligne de commande git autour d'un dépôt rangé sur un chemin que l'instance peut lire et écrire. Une opération par nœud, un chemin de dépôt, et n8n fait ce qu'un développeur taperait dans son terminal. Rien à installer, aucun surcoût côté n8n, que tu sois sur n8n Cloud ou sur une instance auto-hébergée.
Premier terrain de jeu, le plus fréquent : garder la trace des fichiers qu'un workflow fabrique. Un export tombe chaque nuit dans un dossier, Add indexe les chemins concernés, Commit enregistre le changement avec un message, Push l'envoie sur le dépôt distant. Trois nœuds, et chaque export devient une différence lisible des semaines plus tard.
Deuxième usage, en lecture cette fois. Log renvoie l'historique des commits d'un dépôt ou d'un seul fichier, Status dit ce qui a bougé depuis le dernier commit, Reflog retrace les positions successives d'une référence. Cette sortie se dirige ensuite vers un Switch selon ce qui a changé, ou se recoupe avec une autre source grâce à Merge avant d'atterrir dans un rapport.
Troisième cas, préparer une copie de travail. Clone rapatrie un dépôt dans un dossier neuf, Switch Branch se place sur la branche du job, Add Config et User Setup fixent l'identité sous laquelle les commits seront écrits. Au bout de la chaîne, un dossier vide est devenu un dépôt exploitable par le workflow suivant.
Vient la limite, et elle est nette. Ce nœud parle à git, pas à GitHub ni à GitLab. Ouvrir une pull request, commenter un ticket, lire un dépôt via une API web : rien de tout ça n'est à sa portée, et c'est HTTP Request ou un nœud dédié qui prend le relais sur ces appels HTTP. Autre contrainte : le dépôt doit exister sur un système de fichiers accessible à l'instance, donc en pratique une instance auto-hébergée avec un volume monté.
Deux détails à connaître avant de construire. Le nœud s'exécute sur chaque item entrant : huit chemins de fichiers arrivés d'une étape précédente déclenchent huit actions git, sauf si tu les regroupes avant. Et il n'ouvre jamais un workflow, un déclencheur le précède toujours, Schedule Trigger, Webhook ou le trigger d'un outil. Pour aller plus loin sur la plateforme elle-même, l'Avis n8n et la Formation n8n prennent le sujet par le haut.
Qu'est-ce qu'il faut authentifier ?
- 01
Choisir le mode d'authentification
Deux opérations affichent un sélecteur Authentication, Clone et Push, avec deux valeurs possibles :
gitPassword(Authenticate) etnone(None). None convient quand le dépôt distant est public ou quand il s'agit d'un chemin local. Authenticate devient nécessaire dès que le distant réclame un compte. Les autres opérations travaillent en local et ne posent pas la question. - 02
Créer le credential Git
Avec Authenticate, le nœud demande un Credential for Git, c'est-à-dire un jeu d'identifiants enregistré dans n8n. Il se crée une seule fois depuis le menu Credentials, puis se réutilise dans tous les workflows qui en ont besoin. Ce credential fonctionne en basic auth et contient deux champs : un Username et un Password valables sur GitHub, GitLab ou une plateforme équivalente.
- 03
Désigner le dépôt de travail
Chaque opération réclame un Repository Path, le chemin local du dépôt git sur la machine qui fait tourner n8n. Clone sort du lot : il attend un New Repository Path pour le dossier de destination et un Source Repository pour l'URL ou le chemin à copier. Ce chemin peut venir d'une étape précédente sous forme d'expression, la syntaxe n8n qui va chercher un champ de l'item :
{{ $json.path }}.
Quelle opération Git choisir ?
Le nœud Git expose 15 opérations. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Sommaire des opérations
- Add a file or folder to commit
- Add configuration property
- Clone a repository
- Commit files or folders to git
- Fetch from remote repository
- Return current configuration
- Return git commit history
- Pull from remote repository
- Push to remote repository
- Push tags to remote repository
- Return reference log
- Return status of current repository
- Switch to a different branch
- Create a new tag
- Set up a user
Add a file or folder to commit
addCe que tu vois dans n8n
Notes & cas d'usage
Avant d'enregistrer quoi que ce soit, git veut savoir quels fichiers entrent dans le lot. Cette opération fait exactement ça : elle indexe des fichiers ou des dossiers pour le commit suivant.
Paramètres clés
- Paths to Add : la liste de chemins séparés par des virgules, requise, absolus ou relatifs au Repository Path, placeholder
README.md. - Repository Path : le chemin local du dépôt git concerné.
Add configuration property
addConfigCe que tu vois dans n8n
Notes & cas d'usage
La configuration d'un dépôt tient dans des paires clé/valeur. Cette opération en écrit une dans la configuration locale.
Paramètres clés
- Key : le nom de la clé à définir, requis, placeholder
user.email. - Value : la valeur à enregistrer, requise, placeholder
name@example.com. - Mode : option à deux choix,
setpour remplacer le réglage etappendpour l'ajouter plutôt que l'écraser.
Clone a repository
cloneCe que tu vois dans n8n
Notes & cas d'usage
Là où presque toutes les opérations supposent un dépôt déjà présent, celle-ci le crée en copiant un dépôt distant dans un dossier local.
Paramètres clés
- New Repository Path : le chemin local de destination, requis, placeholder
/tmp/repository. - Source Repository : l'URL ou le chemin du dépôt à copier, requis, placeholder
https://github.com/n8n-io/n8n. - Authentication : Authenticate pour transmettre un credential, None pour cloner sans.
Commit files or folders to git
commitCe que tu vois dans n8n
Notes & cas d'usage
Voilà l'opération qui transforme des changements indexés en entrée définitive de l'historique, avec un message pour l'expliquer.
Paramètres clés
- Message : le message du commit, non requis par le nœud, même si un historique sans message se relit très mal.
- Branch : option qui indique la branche sur laquelle basculer avant de committer, placeholder
main; vide, le commit reste sur la branche courante. - Paths to Add : option listant les chemins à committer, placeholder
/data/file1.json; non renseignée, tout ce qui est indexé passe.
Fetch from remote repository
fetchCe que tu vois dans n8n
Notes & cas d'usage
Récupérer sans rien modifier : le fetch télécharge ce que connaît le dépôt distant et laisse la copie de travail intacte.
Return current configuration
listConfigCe que tu vois dans n8n
Notes & cas d'usage
Pendant symétrique de l'écriture de configuration : cette opération renvoie les réglages actuellement appliqués au dépôt.
Return git commit history
logCe que tu vois dans n8n
Notes & cas d'usage
Ici l'historique devient de la donnée exploitable : l'opération renvoie les commits, et la pagination décide combien.
Paramètres clés
- Return All : activé, n8n renvoie tous les commits ; désactivé, il s'arrête à Limit.
- Limit : le nombre maximum de commits renvoyés, disponible seulement quand Return All est désactivé.
- File : option contenant le chemin d'un fichier ou d'un dossier, absolu ou relatif au Repository Path, pour n'obtenir que son historique.
Pull from remote repository
pullCe que tu vois dans n8n
Notes & cas d'usage
Contrairement au fetch, le pull applique les changements distants à la copie de travail : les fichiers sur le disque finissent alignés sur le dépôt distant.
Push to remote repository
pushCe que tu vois dans n8n
Notes & cas d'usage
Un commit reste strictement local tant que cette opération ne l'a pas envoyé, et c'est le second endroit où l'authentification apparaît.
Paramètres clés
- Authentication : Authenticate pour transmettre un Credential for Git, None pour pousser sans credential.
- Branch : option précisant la branche sur laquelle basculer avant le push, placeholder
main; vide, c'est la branche courante qui part. - Target Repository : option contenant l'URL ou le chemin du dépôt visé, placeholder
https://github.com/n8n-io/n8n.
Push tags to remote repository
pushTagsCe que tu vois dans n8n
Notes & cas d'usage
Un push ordinaire laisse les tags derrière lui, et cette opération comble précisément ce manque.
Return reference log
reflogCe que tu vois dans n8n
Notes & cas d'usage
Quand Log liste des commits, le reference log liste les positions successives d'une référence : c'est ainsi qu'on retrouve où une branche est passée.
Paramètres clés
- Reference : option nommant la référence à inspecter, un nom de branche par exemple ; vide, c'est HEAD qui est pris, placeholder
HEAD. - Return All : activé, toutes les entrées reviennent ; désactivé, le résultat s'arrête à Limit.
- Limit : le nombre maximum d'entrées renvoyées.
Return status of current repository
statusCe que tu vois dans n8n
Notes & cas d'usage
Status répond à une seule question : qu'est-ce qui diffère en ce moment entre la copie de travail et le dernier commit.
Switch to a different branch
switchBranchCe que tu vois dans n8n
Notes & cas d'usage
La gestion des branches a son opération dédiée, et ses options couvrent aussi bien la création que le simple déplacement.
Paramètres clés
- Branch Name : le nom de la branche visée, requis, placeholder
feature/new-feature. - Create Branch If Not Exists et Start Point : créer la branche si elle n'existe pas, à partir du commit, de la branche ou du tag donné, ou depuis le HEAD courant.
- Force Switch, Set Upstream et Remote Name : forcer le passage en abandonnant les modifications locales, suivre une branche distante, nommer le distant à suivre, placeholder
origin.
Create a new tag
tagCe que tu vois dans n8n
Notes & cas d'usage
Un tag pose un nom sur l'état courant du dépôt : c'est ce qui donne à une version quelque chose de lisible auquel se référer.
Paramètres clés
- Name : le nom du tag à créer, requis.
Set up a user
userSetupCe que tu vois dans n8n
Notes & cas d'usage
Tout commit porte un auteur. Cette opération règle l'utilisateur du dépôt sans avoir à détailler les clés de configuration.
Besoin d'aide pour automatiser Git avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
Git et n8n, les questions fréquentes
01Le nœud Git n8n est-il gratuit ?
02Quels identifiants faut-il pour le nœud Git ?
03Quelles sont les limites du nœud Git ?
04Nœud Git ou HTTP Request pour automatiser un dépôt ?
05n8n ou Make pour automatiser git ?
Reçois nos tips intégration chaque semaine.
Pas de spam. Désinscription à tout moment.

