# Setup Agent Upgrade Schedule

**By default the system is set to automatically and seamlessly upgrade agents**. Learn here how to configure a custom schedule instead or switch to a manual upgrade process.

{% hint style="info" %}
Automatic upgrades are a "Premium Edition" feature of open-appsec.
{% endhint %}

{% hint style="danger" %}
The explanations provided here relate to open-appsec agent upgrades only, they are not relevant for IPS signature updates.
{% endhint %}

## Configuring upgrade mode

To setup specific schedule or switch to manual upgrades only, navigate to **Profiles->\[select your profile].** See the **Agent Upgrade** section.

Here you can see the latest available version which you can compare with your active agents' versions.\
![](/files/xCuixWlbJKx4QfH0WlNp)

{% hint style="info" %}
You can find the currently installed agent version displayed under the **Agents** option.
{% endhint %}

## Configuring unscheduled automatic upgrades

The default upgrade mode is configured to **Automatic**. In this mode upgrades are performed with each release of a new agent version. 

![](/files/M3B6RPVMokevz9ehOhdr)

## Configuring scheduled automatic upgrades

For scheduled agent upgrades switch the mode to **Scheduled.**\
\
![](/files/mMIBQTKGjqut7jJHJpEo) 

In the **Day of week** field select any combination of days on which you want to allow upgrades to happen.

Configure your desired upgrade window by setting the begin time in UTC in the **Upgrade window starts at (UTC)** field and selecting the maximum allowed upgrade window duration in the **Duration** field between 2 hours and 12 hours (configuration possible in two hour increments).

{% hint style="info" %}
In the example screenshot above scheduled upgrades take place automatically between 2am and 6am only on Sundays, Thursdays and Tuesdays whenever a new upgrade is available.
{% endhint %}

## Disabling automatic upgrades

In order to prevent automatic scheduled or unscheduled upgrades from happening change the upgrade mode to **Manual**.

![](/files/B6qg9SjfskP66LLZYfKE)

This allows you to manually control the upgrade process of your deployed agents.

In order to trigger a manual upgrade hit the **Upgrade Now** button whenever there's a new version available that you want to install. 

{% hint style="warning" %}
The **Manual** upgrade mode option is not recommended unless you need full manual control of all agent upgrades. Instead the recommendation is to always use **Automatic** or **Scheduled** upgrade modes to prevent the agent from not being upgraded for a significant time (= more than three months) as after this time it becomes unsupported! 
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openappsec.io/setup-instructions/setup-agent-upgrade-schedule.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.