Use source control and environments

Feature availability

• Available on Business and Enterprise plans.

• 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.