> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/services/~/revisions/CtwXOp8BlQZpECgk64tz/reader-management-system/documentation/windows-installation-and-operation-manual/installation-and-user-interface.md).

# Installation and User Interface

## Installation

Begin by downloading the <mark style="color:red;">**MagTek Reader Management System**</mark>.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FO8op17Vg4cx4P71N3aXr%2Fimage.png?alt=media&amp;token=7e9307d0-c2b1-4ff6-a817-289f221054e4" alt=""><figcaption></figcaption></figure>

Open the MagTek Reader Management System Windows App.

## Tabs and Buttons <a href="#id-3.2_tabs_and_buttons" id="id-3.2_tabs_and_buttons"></a>

The RMS application has three tabs available at the top of the window as illustrated below. These include File, Utilities and Help.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FlGK87kFDIuaZqqfobEtG%2Fimage.png?alt=media&amp;token=384e3b1d-f506-4fc1-b764-7a2cfe18c0ef" alt=""><figcaption></figcaption></figure>

### File <a href="#id-3.2.1_file" id="id-3.2.1_file"></a>

The File tab has one button, Exit.

* The Exit button closes the application and operates identically to the Exit button in the graphical user interface (GUI).

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FecvEms7T8MNsrXoDFzQo%2Fimage.png?alt=media&amp;token=19c0a96d-815e-486f-94f2-48372ba2839e" alt=""><figcaption></figcaption></figure>

### Utilities <a href="#id-3.2.2_utilities" id="id-3.2.2_utilities"></a>

The Utilities tab has 9 active buttons for use with DynaFlex/DynaProx devices, Offline Mode is reserved for use with MagneSafe Devices.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F74FOxK2Nq87kWRmXxldB%2Fimage.png?alt=media&amp;token=fa20e05c-455c-4646-ba63-83f56053e8d8" alt=""><figcaption></figcaption></figure>

* **Web API Key:** The customer will select this button if they have their own custom Web API Key. This information will be provided by Magensa during onboarding.
* **Clear Screen:** This button removes all content from the Output field, performing the same function as the Clear button in the graphical user interface (GUI).

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FBTA3CiQP2UkaFBV3bWT7%2Fimage.png?alt=media&amp;token=ae1c1e36-c8ba-445e-bed4-02ef8d0e8e81" alt=""><figcaption></figcaption></figure>

* **Detect Device:** This button scans for devices connected to the PC used for interfacing. It operates identically to the Scan button in the graphical user interface (GUI), prioritizing the first detected USB Connection.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F0TCua9azcvNBqHTTVKGR%2Fimage.png?alt=media&amp;token=384c6f61-e1e1-4e2c-a583-006a24a7b580" alt=""><figcaption></figcaption></figure>

* **GetEMVConfigs:** This feature is only available on MagneSafe devices and is not supported on DynaFlex or DynaProx devices. It retrieves device information and logs the data.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F02Nbj9QZMfJ8XdN9D8uJ%2Fimage.png?alt=media&amp;token=c0a7250e-e585-4975-beb6-ab1a04a6aaec" alt=""><figcaption></figcaption></figure>

* **GetConfigList:** This button performs the same function as the Check Config button in the graphical user interface (GUI). It retrieves the device’s current configuration and populates all available configurations in the Configurations dropdown tab.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FeJAZQMNEGgeDwHDDPdZI%2Fimage.png?alt=media&amp;token=77c68569-b497-40ff-ba39-0e1f40cfcf62" alt=""><figcaption></figcaption></figure>

* **Check Tag Updates:** this button will check if the current EMV Tags and CAPKs are up to date and report the results in the output log.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FsErrhGYXn6AEEFBO3U2c%2Fimage.png?alt=media&amp;token=e5cc08e2-5304-4325-88b2-56b77a508f13" alt=""><figcaption></figcaption></figure>

* **Always Update:** When this button is selected, the device will automatically update if its configuration version is lower than the version indicated in the Version field in the GUI. Selecting this button will suppress the “Yes/No” popup dialog (see image below) when an update is available.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FzVIffp70lnWK67cxW0YS%2Fimage.png?alt=media&amp;token=ba117e76-19fa-4040-9e53-411cb30e28ab" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F9naGZz9rmZz74NWEWmU2%2Fimage.png?alt=media&amp;token=541cb565-1df1-4814-9ddd-f73a2c00694f" alt=""><figcaption></figcaption></figure>

The RMS application keeps track of configuration versions in the GUI by indicating a value in Version field as illustrated below. The user may enter 0 in this field to force an update.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FcF7QBZZJcumFW6m1z3fW%2Fimage.png?alt=media&amp;token=c5ab947c-9046-4976-96d3-8d250d503480" alt=""><figcaption></figcaption></figure>

* **Offline Mode (MagneSafe Devices Only):** This button should be selected when the user does not want the RMS application to retrieve firmware or configuration data from external Online sources. The user must make prior arrangements with Magensa to obtain the relevant files and instructions needed for Offline Mode to work properly. This button does not work with DynaFlex/DynaProx devices.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FlTOj63PZJ0regI5WZMNW%2Fimage.png?alt=media&amp;token=6942a75e-cf9c-44f1-b428-94c664905a6c" alt=""><figcaption></figcaption></figure>

* **Auto Start:** When this button is selected, the RMS application will automatically start after launching the application.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FS7vWEOjkpcXGlX1tE2gT%2Fimage.png?alt=media&amp;token=19609638-ca6c-4203-898c-0308ac32fd03" alt=""><figcaption></figcaption></figure>

* **Auto Close:** When this button is selected, the application will automatically close when all updates are complete.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FdWYPWxwJ1qN7AAErCidl%2Fimage.png?alt=media&amp;token=533ca4eb-55fe-4cc3-beb4-f53551010308" alt=""><figcaption></figcaption></figure>

* **Log Output:** When this button is selected, it will enable RMS to store output details in a log file. To see the Log, the user can go to about the Help tab and select the Show Log button.&#x20;

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FIHDq1BVT8RMOrpPqF6yn%2Fimage.png?alt=media&amp;token=a02d3a69-c4d9-4707-b8c0-7a8199f66043" alt=""><figcaption></figcaption></figure>

## Help <a href="#id-3.2.3_help" id="id-3.2.3_help"></a>

The Help Tab contains the About, FAQs and Show Log File options.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F5Wn6VQdVxYW71jbMtbBj%2Fimage.png?alt=media&amp;token=ce1d910e-1bf8-4b98-953b-968acf8abbef" alt=""><figcaption></figcaption></figure>

* **About:** this button displays a window with the name of the application, the version, and application PN number.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FoGS9SGrNgsdBvHGDguTb%2Fimage.png?alt=media&amp;token=514ad4cc-702a-4350-be60-bcee7944e43d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F0gZJgQZvhbiUYTES6ZSL%2Fimage.png?alt=media&amp;token=5d67fe44-d3fa-4a1f-8fdd-d3fd902a53c7" alt=""><figcaption></figcaption></figure>

* **FAQs:** this button takes the user to the MagTek.com support page.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FxhQ1ukUBbQECnKZKRb79%2Fimage.png?alt=media&amp;token=d3a16686-9527-4123-9237-f0902a6021d7" alt=""><figcaption></figcaption></figure>

* **Show Log File:** this button displays txt file log of events only when a device is connected, and the Log Output button is checked in the Utilities Tab. This information is tied directly to the device serial number.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FJCMrzv7ZIHcbHLang9cv%2Fimage.png?alt=media&amp;token=3428deb7-325e-4e9c-a5d0-c2d019a19b40" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FpImkkMUAf5lwLO8iJUZv%2Fimage.png?alt=media&amp;token=65e0044d-268c-4bab-8fdc-89d78e6cc4bb" alt=""><figcaption></figcaption></figure>


---

# 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://developer.magtek.com/services/~/revisions/CtwXOp8BlQZpECgk64tz/reader-management-system/documentation/windows-installation-and-operation-manual/installation-and-user-interface.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.
