../../_docs/deployments/gitops/application-configuration-settings.md

url: "/gitops-app-groups"

- title: Application configuration settings

url: "/application-configuration-settings"

- title: Application configuration settings

url: "/application-configuration-settings"

title: "Application configuration settings"

description: "Review descriptions of configuration settings for Argo CD applications in GitOps"

toc: true

Configuration settings for applications define the application’s structure, sources, destination, and operational behavior.

For ease of use, settings are organized into distinct categories including:

* [Application definitions](#application-definitions): Basic metadata, such as the application name, GitOps Runtime, and the name of the YAML manifest.

* [General configuration settings](#application-general-configuration-settings): Product, Group, source, destination, and sync policies for the application.

* [Advanced configuration settings](#application-advanced-configuration-settings): Tool-specific options, project grouping, and propagation policies for resource and application deletion.

For how-to instructions, see [Create applications]({{site.baseurl}}/docs/deployments/gitops/create-application/).

Application definitions include the application name, the GitOps Runtime, and the name of the YAML manifest. By default, the YAML manifest has the same name as that of the application.

{% include

image.html

lightbox="true"

file="/images/applications/add-app-definitions.png"

url="/images/applications/add-app-definitions.png"

alt="Application definitions"

caption="Application definitions"

max-width="50%"

%}

General configuration settings define the product, group, to which the application belongs, source, destination, and sync policies for the application.

{% include

image.html

lightbox="true"

file="/images/applications/add-app-general-settings.png"

url="/images/applications/add-app-general-settings.png"

alt="General configuration settings"

caption="General configuration settings"

max-width="70%"

%}

Optional. The product to which to assign the application. Select an existing product, or create and add a new product.

Products empower promotions for applications and make for streamlined management and deployments.

See [Products]({{site.baseurl}}/docs/products/about-products/).

Optional. The group or groups to which to add the application. Select an existing group or groups, or create a new application group by typing a name and pressing Enter.

Group applications based on criteria meaningful to your organization, such as environment, region, or any other relevant attribute. You can then view deployments for these applications in the same location in the Groups tab of the GitOps Apps dashboard. A new view for Argo CD applications, Groups allow you to collate multiple applications and view their timelines.

See [Application Groups]({{site.baseurl}}/docs/deployments/gitops/gitops-app-groups/).

The Git repository with the application resources.

{::nomarkdown}<ul> <li><b>Repository URL</b>: The URL of the Git repo or the Helm package repo with the application resources. <br>If SSH is configured for the runtime, you can connect to the repo with either HTTPS or SSH. On selecting the repository, Codefresh automatically updates the URL format. See <a href="https://codefresh.io/docs/docs/installation/gitops/manage-runtimes/#configure-ssh-for-gitops-runtimes">Configure SSH for runtimes</a>.<br>If the Argo CD project is not the <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">default</span> project, make sure that the repo has the correct access roles for your application.<ul><li><b>Revision and Path</b>: Applies to Git repositories. </li><li><b>Chart</b>: Applies to Helm repositories. The name of the Helm package with all the resource definitions for the application, and the version. </li></ul>For more information, see <a href="https://argo-cd.readthedocs.io/en/stable/user-guide/tracking_strategies/" target="\_blank">Tracking and Deployment Strategies</a>.</li></ul>{:/}

The cluster and namespace to which to deploy the application.

{::nomarkdown}<ul><li><b>Cluster</b>: The cluster to which to deploy the application, defined as a <b>URL</b>, or as the user-defined display <b>NAME</b>.</li> <li><b>Namespace</b>: The namespace in the cluster to which to deploy the application.</li><li><b>Auto-create namespace</b>: When selected, automatically creates the namespace in the cluster if it doesn't exist.</li> </ul>{:/}

The synchronization policy to apply when there are differences between the desired state in Git and the actual state in the cluster.{::nomarkdown}<ul><li><b>Manual</b>: Manually sync the changes from the Argo CD UI.</li><li><b>Automatic</b>: Automatically sync changes, with the following options if selected:<ul><li><b>Prune resources</b>:When selected, removes legacy resources that do not exist currently in Git. </li><li><b>Self heal</b>: When selected, always enforces a sync to the desired state in Git, if and when there is a change to the actual state in the cluster. See <a href="https://argo-cd.readthedocs.io/en/stable/user-guide/auto_sync/#automatic-self-healing" target="_blank">Automatic self-healing</a>.</li></li></ul></ul>{:/}

Common to both manual and automatic sync policies.{% raw %}{::nomarkdown}<ul><li><b>Skip schema validation</b>: When selected, bypasses validating the YAML schema.</li><li><b>Auto-create namespace</b>: When selected, automatically create the namespace if the specified namespace does not exist in the cluster.</li><li><b>Prune last</b>: When selected, removes those resources that do not exist in the currently deployed version during the final wave of the sync operation. See <a href="https://argo-cd.readthedocs.io/en/stable/user-guide/sync-options/#prune-last" target="_blank">Prune last</a>.</li><li><b>Apply out of sync only</b>: When selected, syncs only those resources in the application that have been changed and are <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">OutOfSync</span>, instead of syncing every resource regardless of their state. This option is useful to reduce load and save time when you have thousands of resources in an application. See <a href="https://argo-cd.readthedocs.io/en/stable/user-guide/sync-options/#selective-sync" target="_blank">Selective Sync</a>.</li></ul>{:/}{% endraw %}

Defines how resources are pruned, applying Kubernetes cascading deletion prune policies. For more information, see [Kubernetes - Cascading deletion](https://kubernetes.io/docs/concepts/architecture/garbage-collection/#cascading-deletion){:target="\_blank"}.{::nomarkdown}<ul><li><b>Foreground</b>: The default prune propagation policy used by Argo CD. With this policy, Kubernetes changes the state of the owner resource to `deletion in progress`, until the controller deletes the dependent resources and finally the owner resource itself. </li><li><b>Background</b>: When selected, Kubernetes deletes the owner resource immediately, and then deletes the dependent resources in the background.</li><li><b>Orphan</b>: When selected, Kubernetes deletes the dependent resources that remain orphaned after the owner resource is deleted.</li></ul> </br>{:/}

All Prune propagation policies can be used with:

**Replace**: When selected, Argo CD executes `kubectl replace` or `kubectl create`, instead of the default `kubectl apply` to enforce the changes in Git. This action will potentially recreate resources and should be used with care. See [Replace Resource Instead Of Applying Change](https://argo-cd.readthedocs.io/en/stable/user-guide/sync-options/#replace-resource-instead-of-applying-changes){:target="\_blank"}.

**Retry**: When selected, retries a failed sync operation, based on the retry settings configured:

* Maximum number of sync retries (**Limit**)

* Duration of each retry attempt in seconds, minutes, or hours (**Duration**)

* Maximum duration permitted for each retry (**Max Duration**)

* Factor by which to multiply the Duration in the event of a failed retry (**Factor**). A factor of 2 for example, attempts the second retry in 2 X 2 seconds, where 2 seconds is the Duration.

Advanced settings define the tool used to create the application, and related toll-specific settings.

{% include

image.html

lightbox="true"

file="/images/applications/add-app-advanced-settings.png"

url="/images/applications/add-app-advanced-settings.png"

alt="Advanced configuration settings"

caption="Advanced configuration settings"

max-width="70%"

%}

The project group to which the application belongs. A project is useful to enforce restrictions on permitted sources and targets for applications and roles. If not defined, the application is automatically assigned to the `default` project, which is created automatically by Argo CD and has no restrictions.

For more information, see Argo CD's documentation on [Projects](https://argo-cd.readthedocs.io/en/stable/user-guide/projects/#projects){:target="\_blank"}.

Defines how resources are pruned, applying Kubernetes cascading deletion prune policies when you delete the application.

For more information, see [Argo CD's app deletion](https://argo-cd.readthedocs.io/en/stable/user-guide/app_deletion/){:target="_blank"}.

* **Foreground**

The default prune propagation policy used by Argo CD. With this policy, Kubernetes changes the state of the owner resource to `deletion in progress`, until the controller deletes the dependent resources and finally the owner resource itself.

* **Background**

When selected, Kubernetes deletes the owner resource immediately, and then deletes the dependent resources in the background.

* **Non-cascading**

When selected, Kubernetes deletes only the application and not its resources.

The tool used to create the application's manifests. Codefresh supports defining application manifests as a directory, Helm charts, or Kustomize. If you are using other tools to define application manifests, use the Plugin type. For more information, see the Argo CD's documentation on [Tools](https://argo-cd.readthedocs.io/en/stable/user-guide/application_sources/){:target="_blank"}.

* **Directory**: A `directory` application, which is the default application type in Argo CD.

* **Directory recurse**: Optional. Select to include subdirectories.

* **Top-level arguments**: Optional. Select and define parameters.

* **External variables**: Optional. Select and define external variables.

* **Helm**: Create the application as a Helm chart.

* **Values files**: One or more `values.yaml` files to store the parameters.

* **Values**: Optional. When defined, new values not in `values.yaml` files are added, and existing values are overridden.

* **Kustomize**: Create a Kustomize application, with the following settings:

* **Version**: The version of Kustomize used to create the application.

* **Name Prefix** and **Name Suffix**: Optional. The prefix and suffix to be appended to the resources of the application.

* **Plugin**: Use for any other tool.

* **Name**: The name of the Plugin used to create the application.

* **External Variables**: The variables to use in the application.

For example applications, go to the [Argo CD example applications repo](https://github.com/argoproj/argocd-example-apps){:target="_blank"}.

[Monitoring Argo CD applications]({{site.baseurl}}/docs/deployments/gitops/monitor-applications/)

[Managing Argo CD applications]({{site.baseurl}}/docs/deployments/gitops/manage-application/)

[Promotions]({{site.baseurl}}/docs/promotions/promotions-overview/)

[Environments dashboard]({{site.baseurl}}/docs/dashboards/gitops-environments/)

[Product Dashboard]({{site.baseurl}}/docs/dashboards/gitops-products/)

[Home dashboard]({{site.baseurl}}/docs/dashboards/home-dashboard/)

[DORA metrics]({{site.baseurl}}/docs/dashboards/dora-metrics/)

| |[Create Argo CD applications]({{site.baseurl}}/docs/deployments/gitops/create-application/) | Focuses on how-to instructions on creating applications. |

| |[Application configuration settings]({{site.baseurl}}/docs/deployments/gitops/application-configuration-settings/) | Split from **Creating applications** article to a standalone reference article describing the settings you can configure for applications. |