Git sync allows users to use a third-party Git repository for storing project data.
This option is independent of cloud access and is suitable for users familiar with Git workflows.
Key features:
-
Version control: Leverage Git’s version control capabilities for your projects.
-
Independence from Insomnia’s Cloud: Uses external Git repositories for storage.
-
Provider flexibility: Choose any Git service provider, like GitHub, GitLab, or Bitbucket.
-
Collaboration via Git: Collaborate with others using standard Git practices.
-
v10.2+ Built-in conflict resolution: Resolve conflicts in Insomnia when pulling or pushing changes.
When you create a project with Git sync in an organization, it’s only available to you. The project name, its metadata, and the corresponding Git URL are not shared with other users in the organization. To collaborate on a Git sync project, each user must create a project and connect to the Git repository. This allows you to control who can access the project within the organization.
The following diagram shows how data flows when Insomnia is configured with Git sync:
flowchart LR
subgraph userDesktop [User desktop]
A(Insomnia resources
Design documents
Request collections
Unit tests
Environments)
B(Git capabilities
Manage commits
Git pull/push
Git branches)
end
subgraph unsure [ ]
C(Insomnia resources
Design documents
Request collections
Unit tests
Environments)
D(Git capabilities
Manage commits
Git pull/push
Git branches)
end
subgraph insomniaCloud [Insomnia Cloud]
E(
Database)
F(
Google Cloud)
end
subgraph Git-based source code management provider
subgraph .
G(
Bitbucket)
H(
GitLab)
I(
GitHub)
end
end
J(Insomnia resources
RBAC
License)
E <--> J
F <--> J <--> A <--> C
B <--> D
C <--> G & H & I
D <--> G & H & I
style . stroke:none