This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.
Git Sync with regional replication
Deploy multiple Grafana instances across regions. Synchronize them with the same Git location to ensure consistent dashboards everywhere.
Before you begin, ensure you have the following:
- A Git repository hosted on a compatible Git provider.
- A Grafana instance in each region that meets the Git Sync setup prerequisites.
- Network connectivity from every regional instance to your Git provider.
Use it for
Use this scenario in the following situations:
- Geographic distribution: You deploy Grafana close to users in different regions.
- Latency reduction: Users need fast dashboard access from their location.
- Data sovereignty: You keep dashboard data in specific regions.
- High availability: You need dashboard availability across regions.
- Consistent experience: All users see the same dashboards regardless of region.
Architecture
In this scenario, every regional instance syncs the same path of the same branch:
┌─────────────────────────────────────────────┐
│ GitHub Repository │
│ Repository: your-org/grafana-manifests │
│ Branch: main │
│ │
│ grafana-manifests/ │
│ └── shared/ │
│ ├── dashboard-global.json │
│ ├── dashboard-metrics.json │
│ └── dashboard-logs.json │
└─────────────────────────────────────────────┘
↕ ↕
Git Sync (shared/) Git Sync (shared/)
↕ ↕
┌────────────────────┐ ┌────────────────────┐
│ US Region │ │ EU Region │
│ Grafana │ │ Grafana │
│ │ │ │
│ Repository: │ │ Repository: │
│ - path: shared/ │ │ - path: shared/ │
└────────────────────┘ └────────────────────┘Repository structure
The following examples show how the dashboards appear in Git and in every regional instance.
In Git:
your-org/grafana-manifests
└── shared/
├── dashboard-global.json
├── dashboard-metrics.json
└── dashboard-logs.jsonIn Grafana Dashboards view (all regions):
Dashboards
└── 📁 grafana-manifests/
├── Global Dashboard
├── Metrics Dashboard
└── Logs Dashboard- All regional instances (US, EU, and so on) show an identical folder structure.
- Every region has the same folder name,
grafana-manifests. - The same dashboards, synced from the
shared/path, appear everywhere. - Users in any region see the exact same dashboards with the same titles.
Configuration parameters
Configure every regional instance with the following parameters:
- Repository:
your-org/grafana-manifests - Branch:
main - Path:
shared/
How it works
Changes made in any region reach the other regions through Git:
- All regional instances pull dashboards from
shared/. - Any region’s change commits to Git.
- Other regions pull updates during the next sync, or immediately if you use webhooks.
- Changes propagate across regions per sync interval.
Considerations
Keep the following in mind when you run this scenario:
- Write conflicts: If users in different regions modify the same dashboard simultaneously, the last written changes prevail.
- Primary region: Consider designating one region as the primary location for making dashboard changes.
- Propagation time: Changes propagate to all regions within the configured sync interval, or instantly if you configure webhooks.
- Network reliability: Ensure all regions have reliable connectivity to the Git repository.
Learn more
Refer to the following documents to learn more:


