Comment connecter GitHub à n8n pour versionner ses workflows

Connecter GitHub à n8n ouvre la porte au versioning automatique des workflows. Ce tutoriel guide pas à pas la création d'une application OAuth2 sur GitHub, la configuration des credentials dans n8n et un premier test en creant un fichier dans un dépôt directement depuis un workflow.

Etapes de connexion

1. Creer le credential dans n8n

Dans la section Credentials de n8n, créer un nouveau credential de type "GitHub OAuth2 API". Trois informations sont nécessaires : l'OAuth Redirect URL (fournie par n8n, à copier dans GitHub), le Client ID et le Client Secret (fournis par GitHub).

2. Creer l'application OAuth2 sur GitHub

1. Aller dans Settings > Developer Settings > OAuth Apps > New OAuth App
2. Renseigner le nom de l'application (ex : "n8n")
3. L'Homepage URL est obligatoire (mettre l'URL de votre site ou de n8n)
4. Coller l'Authorization callback URL copiee depuis n8n
5. Ne pas activer "Enable device flow"
6. Cliquer sur Register application

Apres l'enregistrement, copier le Client ID et générer un Client Secret a coller dans n8n.

3. Finaliser la connexion

Dans n8n, cliquer sur Connect. GitHub affiche une page d'autorisation listant les permissions demandees. Si vous avez des organisations, vous pouvez les autoriser individuellement. Cliquer sur Authorize pour finaliser. Le message "Connection successful" confirme que n8n est connecté à GitHub.

Premier test : créer un fichier

Configuration du nœud GitHub (action "Create File") :

Champ	Valeur
Credential	Le credential OAuth2 crée
Repository Owner	Votre nom d'utilisateur ou organisation GitHub
Repository Name	Le nom du dépôt (ex : "n8n-test")
File Path	Chemin du fichier à créer (ex : "test.txt")
File Content	Contenu du fichier (texte ou données dynamiques)
Commit Message	Description de la modification

Cas d'usage : versioning des workflows

L'application la plus puissante de cette connexion est le versioning automatique des workflows n8n. En version self-hosted, l'historique des modifications est limite à une journee. En exportant automatiquement le JSON du workflow dans un dépôt GitHub à chaque publication, on dispose d'un historique illimite et versionne. En cas de problème, il suffit de récupèrer la version souhaitée depuis GitHub.