1. Home
  2. SureMDM
  3. How to configure Relay Server using Custom Properties in SureMDM?

How to configure Relay Server using Custom Properties in SureMDM?

KB ID: 42G2207393
Views: 179
Updated: July 2022

The relay server will act as a local intermediate server that can cache files while downloading from the cloud and save them locally and these files can be accessed on the relay server using a local LAN. Once the relay server is configured, devices in the local network will no longer need to download files from the cloud.

Steps to get this arrangement working are

  1. Relay servers need to be set up at a site
  2. Push a relay server access configuration to all devices on that site.

In case the deployment involves a large number of sites and relay servers, it becomes impractical to create and manage hundreds of relay server config jobs and push them to respective site devices.

We can solve the above challenges by creating custom properties for relay server configuration and using them in a single job as wildcards. The same job can be distributed across hundreds of groups with hundreds of devices in each group

A. Steps to configure Custom Properties in SureMDM 

  1. Login to SureMDM Web Console  
  2. Navigate to Account Settings and click on Custom Properties and navigate to  Properties
  3. Click on Add. This will open an Add Custom Properties prompt. Enter the Key and Data Type values and click on OK. Once done, the Key and Data Type will be listed in the Properties table. 

Note: Please use the below example of Key and Data types to create relay server properties.


  1. Key: Relay_server_IP_Address; Datatype: String
  2. Key: Username; Datatype: String
  3. Key: Password1; Datatype: String

4. Further, go back to SureMDM Home Screen and click on any device group. 

5. Goto the device group Properties section and navigate to Custom Properties Tab

6. Click on Import and import the .csv file with the Key, Data Type, and Value.

Note: Please use the below example of Key, Data Types and Values while creating a .csv file.

  1. Key: Relay_server_IP_Address; Datatype: String; Value:
  2. Key: Username; Datatype: String; Value:
  3. Key:Password1; Datatype: String; Value:


7. Once the import is successful, the values will be shown in the properties table.

Note: Send to Device Agent should be enabled at group level to propagate the properties to the device. At the device level, it is propagated by default.


Further, the user will need to create a Relay server job to complete the configuration.

B. Steps to create Relay Server job using wildcards 

  1. Go to SureMDM Home Screen and  click on Jobs 
  2. Click New Job and select Android 
  3. Click Relay Server Configuration 
  4. Enter the values to the parameters in the job as follows : 
    1. Relay URL: $relay_server_ipaddress$
    2. Relay User Name: $username$
    3. Relay Password: $Password1$
  5. Name the Relay Server Job and Save
  6. Go to Home, Select the required Group(s) and apply the job created in Step. 5

Because we used wildcards in the job above, SureMDM will auto replace the wildcard with values from each group before pushing it to devices. The result will be each device will automatically get access configuration for their site Relay server. This vastly reduces the complexity for MDM admin and avoids unnecessary manual errors.

Related Articles