Comment connecter GitHub a n8n pour versionner ses workflows

Connecter GitHub a n8n ouvre la porte au versioning automatique des workflows. Ce tutoriel guide pas a pas la creation d'une application OAuth2 sur GitHub, la configuration des credentials dans n8n et un premier test en creant un fichier dans un depot directement depuis un workflow.

Etapes de connexion

1. Creer le credential dans n8n

Dans la section Credentials de n8n, creer un nouveau credential de type "GitHub OAuth2 API". Trois informations sont necessaires : l'OAuth Redirect URL (fournie par n8n, a 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 generer 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 connecte a GitHub.

Premier test : creer un fichier

Configuration du noeud GitHub (action "Create File") :

Champ	Valeur
Credential	Le credential OAuth2 cree
Repository Owner	Votre nom d'utilisateur ou organisation GitHub
Repository Name	Le nom du depot (ex : "n8n-test")
File Path	Chemin du fichier a creer (ex : "test.txt")
File Content	Contenu du fichier (texte ou donnees 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 a une journee. En exportant automatiquement le JSON du workflow dans un depot GitHub a chaque publication, on dispose d'un historique illimite et versionne. En cas de probleme, il suffit de recuperer la version souhaitee depuis GitHub.