Configuration Sync

Auto-Publish

Configure automatic publishing when bindings or connectors change.

Auto-publish controls whether configuration changes are pushed to edge gateways automatically or require manual action. Each deployment has its own auto-publish setting, so you can use different strategies for different gateways at the same site.

How auto-publish works

When auto-publish is enabled (the default), the platform automatically publishes a new configuration to the edge gateway whenever a relevant change occurs. You do not need to manually trigger a publish — the system handles it for you.

When auto-publish is disabled, the platform marks the deployment's shadow as having pending changes but does not publish. You must manually publish the configuration from the deployment detail page.

Triggers

The following actions trigger auto-publish for all deployments at the affected site:

ActionDescription
Binding createdA new variable binding is created for an asset at the site
Binding updatedAn existing binding's address or parameters are modified
Binding deletedA variable binding is removed
Connector attachedA connector is attached to an asset at the site
Connector detachedA connector is detached from an asset

When any of these actions occur, the platform evaluates each deployment at the site:

  • Auto-publish enabled — the configuration is published immediately
  • Auto-publish disabled — the sync status is set to Pending and a notification is created

Notifications for manual publish

When auto-publish is disabled and a configuration change occurs, the platform creates a notification to alert you that manual action is required. The notification includes:

  • The deployment name
  • The pending config version number
  • A message indicating that manual publish is required

You can view pending notifications from the Notifications section of the platform.

Configuring auto-publish

To toggle auto-publish for a deployment:

  1. Navigate to the site and open the Edge Gateway tab
  2. Select the deployment
  3. In the Configuration section, use the Auto-publish config toggle switch

The change takes effect immediately. Turning auto-publish on does not retroactively publish any pending changes — you must manually publish if there are changes waiting.

When to disable auto-publish

Auto-publish is convenient for most deployments, but you may want to disable it in these situations:

  • Production gateways — where you want to review and approve configuration changes before they reach the edge
  • Shared sites — where multiple team members may be editing bindings and you want to batch changes into a single publish
  • Testing — where you want to make several binding changes before pushing them to the gateway

Even with auto-publish disabled, the platform still generates the configuration and detects changes. The only difference is that the configuration is not pushed to the edge until you manually publish it.

On this page