Advanced Settings

---

General

Auto Update

• Toggle Auto Apply Changes off to prevent the agent from automatically upgrading its components.

  Manual Updates to the Akuity Agent

  With auto upgrades disabled, users must apply the agent updates manually. To accomplish this, go to the Clusters menu for the Kargo instance and click Install Agent on the desired cluster, then run the provided command with the kubectl context set for the corresponding cluster.

Agent Size

note

Agent size configuration is only available for self-hosted Kargo agents.

• In the Agent Size section, choose the size of your Akuity Agent. This selection only impacts the resources allocated to the Akuity Agent within your cluster and does not impact your billing in any way.

  Agent Size	Controller Memory	Controller CPU
  Small	0.5GB	0.25CPU
  Medium	1GB	0.50CPU
  Large	2GB	1CPU
  Auto	Auto	Auto

Kargo Controller Autoscaling (Auto)

caution

The Auto size for Kargo agents is an experimental, alpha-quality feature.

When you set an agent's size to Auto, the Akuity Agent continuously right-sizes the Kargo controller running in that cluster.

If a pod is OOMKilled, the agent detects it immediately and scales up both memory and CPU resources.

CPU and memory scale up when average usage exceeds 80% of the current allocation, and scale down when it drops below 30%, preventing flapping.

Manifests Customization

Akuity Custom Image Registry

• Enter where to pull the agent image from using the Akuity Custom Image Registry field. The default registry is quay.io/akuity.

Argoproj Custom Image Registry

• Enter where to pull the Argo CD images from using the Argoproj Custom Image Registry field. The default registry is quay.io/argoproj.

Kargo Custom Image Registry

• Enter where to pull the Kargo images from using the Kargo Custom Image Registry field. The default registry is quay.io/akuity.

Kustomization

• The Akuity Platform supports customizing the Akuity Agent manifests using a Kustomization.