Source control and environments

Feature availability

• Available on Enterprise.
• You must be an n8n instance owner or instance admin to enable and configure source control.
• Instance owners and instance admins can push changes to and pull changes from the connected repository.
• Project admins can push changes to the connected repository. They can't pull changes from the repository.

n8n uses Git-based source control to support environments. Linking your n8n instances to a Git repository lets you create multiple n8n environments, backed by Git branches.

In this section:

• Understand:
  • Environments in n8n: The purpose of environments, and how they work in n8n.
  • Git and n8n: How n8n uses Git.
  • Branch patterns: The possible relationships between n8n instances and Git branches.
• Set up source control for environments: How to connect your n8n instance to Git.
• Using:
  • Push and pull: Send work to Git, and fetch work from Git to your instance.
  • Copy work between environments: How to copy work between different n8n instances.
• Tutorial: Create environments with source control: An end-to-end tutorial, setting up environments using n8n's recommended configurations.

Related sections:

• Variables: reusable values.
• External secrets: manage credentials with an external secrets vault.