---
title: Controlling AutoSync Behavior in Akuity Argo CD
description: Automatically syncing applications and then disabling AutoSync
---

[Skip to content](https://support.akuity.io/kb/controlling-autosync-behavior-in-akuity-argo-cd#main-content)

English

Show submenu for translations

[![Akuity-Logo-Color-1](https://support.akuity.io/hubfs/Akuity-Logo-Color-1.svg)](https://akuity.io/)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.akuity.io/kb?hsLang=en)
2. [Argo CD](https://support.akuity.io/kb/argo-cd?hsLang=en)
3. [Configuration](https://support.akuity.io/kb/argo-cd?hsLang=en#configuration)

# Controlling AutoSync Behavior in Akuity Argo CD

## Automatically syncing applications and then disabling AutoSync

Akuity Argo CD does not have a built-in toggle to **automatically disable AutoSync** after the initial deployment, but you can achieve this workflow with some manual intervention or automation.

### **Desired Workflow:**

1. A **new cluster** joins the Akuity Argo CD instance.
2. The **ApplicationSet** detects the new cluster and generates applications.
3. The **apps are automatically synced** to the cluster (using AutoSync).
4. **AutoSync is disabled** after deployment to allow manual modifications.

### **Possible Solutions**

#### **1. Manual Update to Remove AutoSync**

- After initial sync, manually update the **Application manifest** to remove the `automated` field under `syncPolicy` or disable the auto sync directly from the UI.
  
    - Example:
      
      `syncPolicy:    automated: {} # Remove or modify this field after initial sync`

#### **2. Using Labels/Annotations in ApplicationSet**

- Add a **custom label/annotation** (e.g., `autosync: enabled`) to toggle AutoSync.
- Once apps are synced, update the label to `autosync: disabled`.
- This can be automated via a **CI/CD job or script** that calls the Argo CD API to update the ApplicationSet.

#### **3. Using ApplicationSet’s `applicationsSync` Policy**

- The **`applicationsSync`** setting in the **ApplicationSet** can prevent unwanted modifications after the initial deployment.
  
    - Example:  
      `syncPolicy:`  
      `  applicationsSync: create-only # Prevents ApplicationSet controller from modifying or deleting Application`
- More details: [Argo CD Documentation](https://argo-cd.readthedocs.io/en/stable/operator-manual/applicationset/Controlling-Resource-Modification/#managed-application-modification-policies)

### **Key Takeaway**

While Akuity Argo CD does not natively support turning **AutoSync off automatically after initial deployment**, you can achieve this by **manually updating the sync policy or using labels.**

- [Argo CD](https://support.akuity.io/kb/argo-cd?hsLang=en#main-content)

    - [App of Apps](https://support.akuity.io/kb/argo-cd?hsLang=en#app-of-apps)
    - [Configuration](https://support.akuity.io/kb/argo-cd?hsLang=en#configuration)
    - [ApplicationSet](https://support.akuity.io/kb/argo-cd?hsLang=en#applicationset)
- [Akuity Platform](https://support.akuity.io/kb/akuity-platform?hsLang=en#main-content)

    - [Audit Logs](https://support.akuity.io/kb/akuity-platform?hsLang=en#audit-logs)
    - [IP Allow Lists](https://support.akuity.io/kb/akuity-platform?hsLang=en#ip-allow-lists)
    - [Terraform](https://support.akuity.io/kb/akuity-platform?hsLang=en#terraform)
    - [Configuration](https://support.akuity.io/kb/akuity-platform?hsLang=en#configuration)
    - [Agents](https://support.akuity.io/kb/akuity-platform?hsLang=en#agents)
    - [Troubleshooting](https://support.akuity.io/kb/akuity-platform?hsLang=en#troubleshooting)
- [Kargo](https://support.akuity.io/kb/kargo?hsLang=en#main-content)

    - [Configuration](https://support.akuity.io/kb/kargo?hsLang=en#configuration)
    - [Warehouses](https://support.akuity.io/kb/kargo?hsLang=en#warehouses)
    - [Metrics](https://support.akuity.io/kb/kargo?hsLang=en#metrics)
- [Self-hosted Akuity Platform](https://support.akuity.io/kb/self-hosted-akuity-platform?hsLang=en#main-content)

    - [Configuration](https://support.akuity.io/kb/self-hosted-akuity-platform?hsLang=en#configuration)

[![Akuity-Logo-Color-1](https://support.akuity.io/hubfs/Akuity-Logo-Color-1.svg "Akuity-Logo-Color-1")](https://akuity.io/)

Akuity.io Help Center

Copyright © 2025, Akuity Inc.