> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/access-control/troubleshooting/upgrade-or-downgrade-allegion-gateway-firmware-with-the-allegion-engage-app.md).

# Upgrade or Downgrade Allegion Gateway Firmware with the Allegion ENGAGE App

To manually update the firmware on a GWE hub or lock, you must sign in to the ENGAGE app on your iPhone or Android device with an account added to the Allegion Engage site. If you are not a part of the Allegion Engage site, follow the steps [here](https://help.verkada.com/access-control/installation/wiring-best-practices-for-third-party-wireless-locks/engage-wireless-lock-online-integration.md#set-up-the-allegion-engage-site-for-integration) to invite yourself to the site.

{% hint style="warning" %}
Before starting the firmware update in the app, ensure your mobile device has at least 50% battery remaining.
{% endhint %}

***

## Upgrade or downgrade firmware

{% tabs %}
{% tab title="Upgrade the GWE hub" %}
{% stepper %}
{% step %}
In the ENGAGE app, select a device from the device list, then select **Update Firmware**.

<div align="left" data-with-frame="true"><figure><img src="https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2FGbvYjBUQcq8EJrYASx7d%2FStep1.PNG?alt=media&amp;token=4ea1297b-3832-450f-a02b-7fc15259514e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Press the **Update** button. The update should start automatically by downloading the latest available firmware version. You will then be prompted to connect to the lock’s WiFi signal to transfer the update file.

Alternatively, press and hold the **Update** button to select the specific version you want to update to.&#x20;

<div align="left" data-with-frame="true"><figure><img src="https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2FTlSBaGOwM25iWWFNNwEr%2FStep2.PNG?alt=media&amp;token=6bd2a6dd-834b-4bb7-9434-445f1aa0a990" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
After the update completes, you will see a screen indicating that the update was successful.

If the update fails, continue with [troubleshooting](#troubleshooting).
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Downgrade the GWE hub " %}
{% stepper %}
{% step %}
In the ENGAGE app, select a device from the device list, then select **Update Firmware**.

<div align="left" data-with-frame="true"><figure><img src="https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2FGbvYjBUQcq8EJrYASx7d%2FStep1.PNG?alt=media&amp;token=4ea1297b-3832-450f-a02b-7fc15259514e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Press and hold the update button at the bottom of the screen.

<div align="left" data-with-frame="true"><figure><img src="https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2FTlSBaGOwM25iWWFNNwEr%2FStep2.PNG?alt=media&amp;token=6bd2a6dd-834b-4bb7-9434-445f1aa0a990" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Select the desired version from the list.

<div align="left" data-with-frame="true"><figure><img src="https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2FH70S2Nwgu1nYEK4U4ZxC%2FStep3.PNG?alt=media&amp;token=32935b74-1103-457e-bb22-36adfffda2e2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
After the update completes, you will see a screen indicating that the update was successful.

If the update fails, continue with [troubleshooting](#troubleshooting).
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

***

## Troubleshooting

If the update fails, send the device logs to Allegion, then contact [Verkada Support](https://help.verkada.com/command/need-help/contact-verkada-support.md) to report the failure.

{% stepper %}
{% step %}
Stay connected to the hub, or reconnect if you got disconnected after the update attempt, then click **Settings**.

<div align="left" data-with-frame="true"><figure><img src="https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2FT2fIV7LlHMBslD04Z5wA%2FDevice%20logs_step1.PNG?alt=media&amp;token=73146ad5-1c52-4afa-bf56-48ff0193250a" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Click the **Send Device Logs** button.

<div align="left" data-with-frame="true"><figure><img src="https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2FycX3sp41sQYj1GJ1mvDN%2FDevice%20logs_step2.PNG?alt=media&amp;token=f42c9035-7e52-43d9-b1ba-11879e0eb27b" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Your phone will connect to the hub's Wi-Fi signal to download the logs and send them to Allegion.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.verkada.com/access-control/troubleshooting/upgrade-or-downgrade-allegion-gateway-firmware-with-the-allegion-engage-app.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
