GitOps for n8n: Treating Workflows as Code
Session Abstract
n8n-gitops is an open-source CLI that applies GitOps principles to n8n workflows. This talk shows how workflows can be exported, reviewed, versioned, and deployed from Git instead of manually promoted via the UI. Through a live demo, we explore safer deployments, rollbacks, and lessons learned operating automation as code.
Session Description
Automation workflows frequently run critical business logic, yet they are often excluded from the same operational discipline applied to application code. In many teams, n8n workflows are created visually, copied between environments, and modified directly in production, making changes hard to audit, review, or roll back.
This talk presents n8n-gitops, an open-source project that explores how GitOps principles can be applied to n8n without changing how workflows are authored.
The session starts by framing the problem: why manual promotion of workflows, UI-driven deployments, and inline code create operational risk as systems grow. From there, we introduce the core ideas behind n8n-gitops: treating Git as the single source of truth, exporting workflows in mirror mode, externalizing code for proper review, and deploying deterministically from Git references.
A live demonstration will show:
- Exporting workflows from n8n into a Git repository in mirror mode
- Externalizing Python and JavaScript code into first-class files
- Reviewing workflow changes using normal Git diffs and pull requests
- Deploying workflows from a specific Git tag or commit
- Rolling back safely by redeploying a previous Git reference
The second half of the talk focuses on lessons learned:
- What GitOps brings to automation platforms
- Why credentials are intentionally excluded from full automation
- Trade-offs compared to UI-driven or enterprise Git integrations
When this approach improves safety—and when it adds unnecessary friction
This is not a product presentation, but an experience report on extending GitOps beyond infrastructure into workflow engines, aimed at engineers working with operations, automation, and platform tooling who want stronger guarantees around change, traceability, and deployment.
