Configure a Grid

A JFrog Grid automatically syncs Project, Access, and Lifecycle entities across all its member sites. The Grid maintains a uniform workspace without manual updates by platform Admins.

Plan The Grid

Review your existing subscription topology to identify JPD sites to include in the Grid.

Identify patterns of frequent manual updates between sites.
Identify sites that would most benefit from a uniform User, Access, and Project workspace.

Consider the purpose of each site in your SDLC, its geographical location, and the teams it supports.

Multiple Grids: The JPD you use to define and monitor the Grid must run the Mission Control service. In most JFrog SaaS subscriptions Mission Control only runs on a single JPD. If your SaaS subscription includes another JPD that runs Mission Control, you can define more than one Grid in the subscription. Consult with your JFrog Customer Success representative.

One Grid per JPD: each JPD site can be a member of only one Grid at a time.

JPDs from different subscriptions can be members of a single Grid. You must define a Circle of Trust that includes all JPDs of the Grid. See Prepare Sites to Join the Grid.

Federated Services: these federation services sync entities not currently synced by the Grid, and continue to operate normally on sites that are added to a Grid:

Federated repositories
Curation Federation

The Grid syncs all entities handled by an Access Federation. This means that:

A Grid cannot contain multiple sites in the same Access Federation - the Grid syncs Access entities across its sites, and cannot coexist with updates initiated by the Access Federation service.
A Grid member site that is also part of an Access Federation can send and receive updated Access entities to/from other sites in the Access Federation that are not part of its Grid.

It is recommended to define JFrog Grid and Access Federation on mutually exclusive groups of sites. Consult with your JFrog Technical Support representative during planning.

Prepare Sites to Join the Grid

Choose the sites in your subscription that you want to add to the Grid.
- Sites must part of an Enterprise + subscription
- Currently only SaaS sites can be included in a Grid.
- Select only full-service JPD sites. Edge Nodes are not supported.
- Select no more than one site of each Access Federation in your subscription.
Identify the Main Site of the Grid: The main site of the Grid is the JPD on which you create and manage the Grid. The main site JPD must run the Mission Control service. Log in to a JPD in your subscription and go to Administration > Topology > JPD Services.
- If there is no JPD Services option in the Topology menu, then Mission Control does not run on this JPD. Repeat this step with another JPD in your subscription.
- If there is a JPD Services page, go to Topology > Grid. This verifies that Mission Control is running, and you can define the Grid on this JPD. This is the Main Site JPD.
Review candidate JPDs: On the Main Site JPD, go to Administration > Topology > JPD Services. The table lists JPDs that were registered in this JPD.
JPDs from this JFrog SaaS subscription are ready to be added to the Grid. JFrog automatically configures a Circle of Trust for all JPDs in the subscription.
To include JPDs from a different subcription in the Grid:
- In JPD Services register the JPD using its pairing token.
- Contact JFrog Support to establish the Circle of Trust between the Main Site and any JPDs from another subscription.

Configure a Grid

You can use Grid API endpoints to perform this procedure. You must be a Platform Admin to perform this procedure.

To configure a grid using the Platform Administration interface:

Verify that all sites of the Grid are live and connected.
Log in to the main site you used to Prepare the Grid sites.
Go to Administration > Topology > Grid.
- To define a new Grid, click Create Grid. The Grid Definition pane appears.
- To modify an existing Grid, click Edit Grid. The Edit Grid pane shows the current Grid configuration.
In the Member Sites tab, do the following:
- Enter a name in the Grid Name field, such as Grid_CI or Test Sites.
- Enter a brief description of the Grid that indicates the management purpose of the Grid, or the shared function of the sites you include in this Grid.
- The Select Sites area lists JPDs that are registered in this JPD and fulfill the criteria to join a Grid. Select the sites that you want to include in the Grid. A site can be a member of only one Grid at a time.
When you first define the Grid, JFrog generates a unique Grid Key identifier. You cannot modify this value. The Main site on which you define the Grid is always included in the Grid, and cannot be removed.

When you edit an existing Grid, you can modify the Name and Description fields, and add or remove sites from the Grid.
Click Next. The Review and Create tab lists the sites you added to the Grid. It also lists the Global Entities that will be synced by the Grid and no longer maintained locally on each site. Check the settings you defined.
To create the Grid with these settings, click Create Grid.

The Grid service checks each site for:
- Health & Network connectivity
- Membership in the Circle of Trust
- Enterprise+ Subscription with Grid entitlement
- Conflicts with Access Federation
Grid creation continues only if all selected sites meet these qualifications.

The Grid service creates the Grid and configures the mesh topology on each site. Then, The Grid service copies Global Entities between sites so they are identical on all sites. The most recent version of each entity is used (Last Write Wins). Less recent versions are overwritten during sync, and cannot be restored.
After initial sync the Grid table displays the member sites of the Grid and their current status.

If you edited an existing Grid, sites you removed no longer appear in the table. The Global Entities synced by the Grid are not erased or rolled back. The most recent updates remain on these sites, but the Grid no longer updates them on these sites.