> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/device-software/adding-a-new-version-of-device-software.md).

# Adding a new version of Device Software

### Introduction

This procedure enables an operator with the "Configure Site" privilege, to add a new version of software to Controller 6000s or Controller Customisations.

**Note:** Controller Device Software upgrades should be performed when there is no card activity occurring, (i.e. card badging). This will reduce the chance of alarms occurring while the Controller is being upgraded.

### Procedure

1. Click **Configure** from the menu bar, then **Device Software**.

   The **Device Software** List Window opens (in [grid view](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/list-windows/grid-view.md)).
2. **Right click** and select **New\...**, and then the appropriate software option.

   By default the **General** tab displays.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-13ddc783934dc06e426c8ff4fc1b97f810ef817b%2Fdevicesw_new.png?alt=media)
3. Complete the fields as required.

   For further detail see [General tab](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/general-tab.md).
4. Click the **Version** tab.

   **Note:** This screen example shown is that of the Controller Software, however this tab looks the same for Controller Customisation.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-332d9e3370fbee5aeb63bf94ef46eb6be8da7da6%2Fdeviceswversion.png?alt=media)
5. Click the **Browse** button and path your way to either:
   * the Device Software File ( **\*.fts** ), containing the correct version of code for this device, OR
   * the Software Package ( **\*.gglsec** ), which is only available for the Controller 6000.

     ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-2c9f350e5107cb4330580c4b92e7f3fe06199b96%2Fsw_package.png?alt=media)
6. Highlight the file once located and click the **Open** button.

   The version of software displays in the **Software Version** field.

   The name of any software selected will automatically populate the **Name** field on the **General** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-94e4c3074ad91d95f3a9012c0ef7004095515ace%2Fsw_package_name.png?alt=media)

   When a Software Package ( **\*.gglsec** ) is selected, once the software has downloaded, the individual device files that are included in the vCR file package display on the **Version** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-27d7d69a0aa507205dba908a6a331b6e7b2150fa%2Fdeviceswversion_swpackage.png?alt=media)
7. Click the **Custom Fields** tab if you want to add and assign a custom field value to this device.

   For further details regarding the **Custom Fields** tab, see [Custom Fields](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/custom-fields.md).
8. Click the **Notes** tab if you want to add a note(s) about this device.

   For further details regarding the **Notes** tab, see [Notes](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/notes.md).
9. Click **OK** to exit and save your changes.

   Click **Cancel** to exit without saving your changes.

   Click **Apply** to save your changes and stay in this window.

### Result

A new version of software has been added for the device.

### Hint

{% hint style="info" %}
**Deleting obsolete Device Software items**

Refer to [Deleting items](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/deleting-items.md) for the procedure on how to delete an obsolete Device Software Item.
{% endhint %}


---

# 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.security.gallagher.com/knowledge-hub/configuration-client/site-installation/device-software/adding-a-new-version-of-device-software.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.
