> For the complete documentation index, see [llms.txt](https://docs.openappsec.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openappsec.io/setup-instructions/setup-agent-upgrade-schedule.md).

# 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 available exclusively with a Check Point WAF or open-appsec Premium Edition (deprecated) subscription.
{% 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.\
![](https://1225393248-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNcZmX14M2KdTBrq9EOnI%2Fuploads%2FywYv2vR1Iete1KDLfHoC%2Fimage.png?alt=media\&token=eeb6cf70-6030-4664-a7ec-15513855bab0)

{% 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. 

![](https://1225393248-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNcZmX14M2KdTBrq9EOnI%2Fuploads%2F5EpFKah1VgIxGI6WXhk8%2Fimage.png?alt=media\&token=3003d5d1-d2b2-4604-a85c-65c4df923314)

## Configuring scheduled automatic upgrades

For scheduled agent upgrades switch the mode to **Scheduled.**\
\
![](https://1225393248-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNcZmX14M2KdTBrq9EOnI%2Fuploads%2FcJFPpiiFXfbWMpSf7HPP%2Fimage.png?alt=media\&token=a11c2a43-25ce-462b-ad44-6e8fa5474edd) 

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**.

![](https://1225393248-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNcZmX14M2KdTBrq9EOnI%2Fuploads%2FZAMjTAy6QTt9Ad4BPM5R%2Fimage.png?alt=media\&token=068ad9cc-1bed-4d7c-9d9a-1e4bb40e360c)

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 %}