General Settings

Change Version

The version of a managed Kargo instance can be upgraded (or downgraded) easily using the Akuity Platform.

1. Navigate to Kargo → your instance → Settings → General.

2. Under Instance, select your desired version.

3. Click Save.

Once saved, the Akuity Platform will automatically update the instance. After the operation is complete, the instance will show a healthy status in the dashboard, indicating success.

caution

Changing the version of the instance will trigger an update of the Akuity Agent on all connected clusters. The operation is carried out by a temporary job executed in the agent's namespace.

Automatic updates to the Akuity Agent can be disabled by default for all clusters on an instance and per cluster. See Disable Auto Upgrade in Agent Advanced Settings.

note

A similar job is used when modifying cluster options such as Agent size, Labels or Annotations, to automatically update the agent configuration in the connected clusters.

Global Namespace Settings

The global namespaces are a list of Kargo Project namespaces that house credentials/service accounts made available to all Projects. This is useful for centrally managing shared service accounts which have access to all projects or shared credentials (such as read-only container image registry credentials) that would be used in multiple projects.

Default Shard Agent

The Default Shard Agent is a feature that allows you to designate a specific Akuity Agent to handle shard operations for your Kargo instance. The default agent will reconcile all Kargo Stages that are not assigned to a specific shard.

Instance Termination Protection

Instance termination protection prevents a Kargo instance from being accidentally deleted. When enabled, any attempt to delete the instance will be blocked until the protection is explicitly disabled.

To enable termination protection:

1. Navigate to Kargo → your instance → Settings → General.

2. Toggle the Enable Termination Protection switch.

3. Optionally, enter a message in the Instance Protection Notes field. This message is displayed to anyone who attempts to delete the instance, and can be used to explain why the instance is protected or who to contact for more information.

4. Click Save.