Updates (OTA)

Update VMGateClient, VMGate Audio, and the USB board from the field.

Check for updates

On the main screen, tap CHECK FOR UPDATES. The update screen opens and contacts VMGateServer (status may show Contacting VMGateServer… then Checking…).

Outcomes:

• You are on the latest version — no action needed.
• Update available — tap Download & install for the listed version.
• Required update — install before continuing production traffic.

The phone needs working internet to VMGate update endpoints. Corporate firewalls or proxies that block HTTPS downloads will stall OTA.

Updates are paused while a call is active (Paused during active call). Finish or end the call, then retry.

Do not sideload APK files from other sources — use OTA or the portal Client QR Codes build only (chapter 03).

Installing an app update

After you confirm download, the app shows progress (Downloading…, Verifying…, Installing…). Wait until it completes — do not force-close VMGateClient mid-install.

Successful OTA replaces the existing signed build and keeps profiles and settings when the signature matches the fleet release key.

If install fails, note the on-screen error and use Try again. Low free storage causes download or install failure — keep at least 500 MB free (chapter 02).

VMGate Audio after OTA

Main app and VMGate Audio ship with matched version codes. After a main-app OTA, Android may prompt to install or update VMGate Audio — accept every time.

Declining the helper install causes audio failures even when VMGateClient shows the latest version. Confirm both packages under menu → Settings → Diagnostics.

USB board update

When your administrator or release notes say to update the USB board, use menu → Dongle management (installing a new VMGateClient version alone does not update the board).

1. Open menu → Dongle management.
2. Connect the dongle to the right port (flash port — see the on-screen diagram).
3. Allow USB access when Android asks.
4. Tap Flash the dongle now and wait until Firmware successfully flashed appears.
5. Unplug from the right port and reconnect on the left port for daily calls.

Do not unplug during flash. If the first attempt times out, unplug the right port, replug, and flash again. End any active call before flashing (End the active call before flashing the dongle).