> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safesquid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration Sync

> Discover how to enable configuration synchronization across a SafeSquid proxy cluster to ensure consistent policy deployment, reduce administrative overhead, and improve system reliability and security.

# Keep all proxy nodes in sync with master configuration

Without configuration synchronization, each proxy node must be updated manually. Inconsistencies cause policy gaps, vulnerabilities, and extra maintenance. SafeSquid configuration sync propagates policy and settings from the master to slave nodes so all nodes stay uniform and administrative overhead is reduced.

## What gets synced

**Synchronized from master to slaves:**

* Access policies (Access Restriction, Content Security, etc.)
* User groups and identity rules
* SSL Inspection settings
* Application signatures and web categories
* Extended policies (DLP, Anti-Virus, etc.)

**NOT synchronized (local to each node):**

* Network interface settings (IP, ports)
* System logs (each node logs independently)
* Performance counters
* Startup parameters (including master IP/port on slave)

## How sync works

* **Trigger**: Sync occurs automatically when you make configuration changes on the master and apply them
* **Frequency**: Near real-time (within \~1-5 minutes after applying changes on master)
* **Mechanism**: Slaves poll master at regular intervals for configuration updates
* **Restart required**: Some changes (e.g., startup params, network settings) require slave restart to apply

## Prerequisites

* Master and slave instances already connected (see [Master-Slave setup](/Master_Slave))
* If authentication is enabled on master, slave IP must be in Access Restriction → Allow list

**Important**: If proxy authentication is required for all network traffic, create an allow-list policy on the master for the slave proxy IP. Otherwise the slave cannot reach the master Configuration Portal to sync policies.

Below is an example of creating a user group for the slave proxy instance:

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image1.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=33600710e7e686dd5796ac4e8a0197fe" alt="A screenshot of a computer" width="1920" height="612" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image1.webp" />

## Configure sync on slave server

Perform these steps on each slave server to enable configuration sync from the master.

## Access the web interface and go to Support

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image2.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=b5e9361c29df963d2c2cc90ab992a75e" alt="accessing safesquid web interface and going to support " width="1593" height="767" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image2.webp" />

## Select Startup Params

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image3.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=79f27be5ca337cf326d9ad3bf9881221" alt="selecting setup params option" width="1598" height="776" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image3.webp" />

## Click on the edit button.

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image4.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=444fb5c2a0f4e85087cc6bfa183e3afe" alt="clicking on edit button" width="1596" height="795" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image4.webp" />

## Add the master proxy server IP address

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image5.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=c906f878c44d58c646bd25a71a10b7c4" alt="Adding the master proxy server IP address" width="1599" height="756" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image5.webp" />

## Add the master proxy server port number

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image6.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=ffb9c9427dc80af11915fee5b9630874" alt="Adding the master proxy server port number" width="1599" height="816" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image6.webp" />

## Now click on the correct icon to save the configuration.

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image7.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=b4a970ebba3022f4916a69b645fc9863" alt="clicking on the correct icon to save the configuration" width="1597" height="752" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image7.webp" />

## Now click on restart for applying changes.

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image8.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=48edfe8dfcff67b20f2a94e290ed50f4" alt="clicking on restart for applying changes" width="1584" height="749" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image8.webp" />

Click **Yes** to back up SafeSquid configuration to the cloud, or **No** to skip cloud backup.

Click **Submit** after selecting the appropriate option.

<img src="https://mintcdn.com/safe-squid-labs-12a0916f/2cNDqI_cln6wbLTp/images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image9.webp?fit=max&auto=format&n=2cNDqI_cln6wbLTp&q=85&s=1a89cb7395435f294ca8de6105a200f4" alt="clicking on submit after selecting yes or no for backup configuration" width="1585" height="755" data-path="images/How_to_Setup_Configuration_Sync_in_a_SafeSquid_Proxy_Cluster/image9.webp" />

After restart, the slave begins syncing configuration from the master. Policy changes made on the master will propagate to this slave automatically.

## Verify sync is working

1. Make a test policy change on the master (e.g., add a test user group)
2. Apply the change: Configuration Portal → Support → Restart SafeSquid (on master)
3. Wait 1-5 minutes
4. Open Configuration Portal on the slave
5. Verify the test policy appears on the slave

**Expected result**: Changes made on master appear on slave within a few minutes without manual intervention.

## Troubleshooting

**Policies not syncing to slave:**

* Verify slave Startup params show correct master IP and port: Configuration Portal → Support → Startup Params
* Check network connectivity from slave to master: `telnet <master-ip> 8888`
* If authentication enabled, verify slave IP in master Access Restriction → Allow list
* Restart slave: Configuration Portal → Support → Restart SafeSquid

**Sync is slow (>10 minutes):**

* Check network latency between master and slave: `ping <master-ip>`
* Verify master is not overloaded (CPU/memory usage)
* Check slave logs for sync errors: `tail -f /var/log/safesquid/extended.log`

**Changes sync but don't apply:**

* Restart slave to apply configuration changes: Configuration Portal → Support → Restart SafeSquid
* Some changes (network settings, startup params) require manual restart

**Related**: [Master-Slave setup](/Master_Slave), [Configuration Portal](/Configuration_Portal), [Troubleshooting](/Troubleshooting)


## Related topics

- [Proxy Clustering](/use_cases/scaling_and_high_availability/proxy_clustering.md)
- [startup.ini tunables](/admin_guide/start_here/startup_ini.md)
- [Master-Slave](/use_cases/scaling_and_high_availability/master_slave.md)
- [Cloud Deployment](/getting_started/install_safesquid/cloud_deployment.md)
- [Verify Failover](/deployment/verify_failover.md)
