Skip to content

Manual Configuration

Overview

The GroundControl VGRS configuration is stored in the appsettings.json file, located at:

<Install Location>\GroundControl VGRS\app\appsettings.json

This file can be modified manually to configure parameters that are not available through the Manager Tool. After modifying the configuration file, the GroundControl VGRS services must be restarted for the changes to take effect.

Manual-Only Configuration Parameters

The following parameters can only be configured by manually editing the appsettings.json file. These settings are not accessible through the Manager Tool.

Parameter Type Description Default Value Example
PackageLicenseDirectory String Full path to the PackageLicenses directory. Required to display package licenses in the Information section. Not set C:\Program Files\GroundControl VGRS\app\PackageLicenses
ShowSDSFromReservedAdresses Boolean Display automatic confirmation messages received when sending SDS or Status SDS messages. false true
SubscriberUpdateTimeoutInMinutes Integer Interval in minutes for automatic subscriber register updates from the TETRA base station (see Management/Subscriber Register). 15 30
SubscriberLoadingTimeoutInSeconds Integer Timeout in seconds for waiting on subscriber register loading responses. A value between 15 and 30 seconds provides a good balance between reliability and performance in most cases. 300 20
Coverage Array Defines signal strength ranges and their color-coding for the Heatmap. Each entry specifies a range (from/to in dBm), a hex color code, and an optional label. See example See Heatmap documentation

Configuration Procedure

  1. Stop the GroundControl VGRS services
  2. Open appsettings.json in a text editor
  3. Modify the required parameters
  4. Save the file
  5. Restart the GroundControl VGRS services

Administrator Rights Required

Editing the appsettings.json file may require administrator privileges, as GroundControl VGRS is installed in the C:\Program Files directory by default. Ensure you run your text editor with administrator rights to modify the configuration file.