n8n-sync — Git-based version control for n8n Community Edition workflows
If you are self-hosting n8n Community Edition, you already know the pain: no built-in version control. Enterprise has Source Control at €667/mo, but for Community users, there is nothing. I got tired of manually exporting workflow JSON, committing it, and fixing credentials by hand when promoting from staging to production. So I built n8n-sync — a CLI that gives you Git-friendly version control…
If you self-host n8n Community Edition, you're likely familiar with the lack of built-in version control. Enterprise users enjoy Source Control for €667/month, but Community users have no such option. Frustrated by manually exporting workflow JSON, committing it, and fixing credentials when promoting from staging to production, developer Badwal created n8n-sync, a CLI tool that provides Git-friendly version control for n8n workflows.
n8n-sync features include:
- Pull: Export all workflows to normalized JSON files for easy diffing
- Push: Create/Update workflows with credential mapping + dry-run
- Diff: Show semantic differences between local files and your instance
- Status: List all workflows with drift detection
Useful features include:
- Diff --check exits 1 on drift, perfect for CI pipelines
- Credential mapping between staging/production without manual fixes
- YAML frontmatter + sorted JSON makes Git diffs actually readable
- No n8n Enterprise required
To get started, run:
1. n8n-sync init
2. n8n-sync pull
3. n8n-sync diff --check
4. n8n-sync push --dry-run
5. n8n-sync push
n8n-sync eliminates the black box nature of self-hosted n8n workflows by treating them as first-class Git citizens. This gives you history of changes, ability to review workflow modifications before going live, CI/CD integration, credential management across instances, and rollback capabilities for broken workflows.
For more information, visit the repository at https://github.com/badwalx/n8n-sync. Share your feedback and let Badwal know what else would make this tool even more useful for your workflow.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.