Skip to content
Docs

Configuration Profiles

Configuration profiles allow you to define a set of device settings once and deploy them to individual devices or entire fleets.

How Profiles Work

Section titled “How Profiles Work”
graph LR
  A[Profile<br/>Settings] --> B[MQTT Push<br/>Cloud]
  B --> C[Device<br/>Apply]
  C --> D[Report Status]
  1. Admin creates a configuration profile with desired settings
  2. Profile is pushed to target devices
  3. Device validates and applies the configuration
  4. Device reports success/failure back to the platform

Configurable Parameters

Section titled “Configurable Parameters”

Network Settings

Section titled “Network Settings”
ParameterDescription
LAN IPRouter LAN interface IP
DHCP RangeDHCP pool start/end
Static LeasesReserved IP assignments
DNS ServersGlobal DNS configuration
DNSSECDNS security validation

WiFi Settings

Section titled “WiFi Settings”
ParameterDescription
Radio EnableTurn radio on/off
SSIDNetwork name
PasswordNetwork passphrase
EncryptionSecurity mode
TX PowerTransmit power level
MAC FilterAllow/block list

WAN Failover

Section titled “WAN Failover”
ParameterDescription
Primary WANPreferred connection
Failover TargetBackup connection
Check HostHealth check destination
Check IntervalSeconds between checks

VPN (WireGuard)

Section titled “VPN (WireGuard)”
ParameterDescription
EnableWireGuard on/off
Peer ConfigRemote peer details
Allowed IPsRoutable networks
MTUPacket size limit

GPS Settings

Section titled “GPS Settings”
ParameterDescription
EnableGPS service on/off
ProtocolNMEA or TAIP
Report IntervalPosition report frequency
System IDDevice identifier

Port Forwarding

Section titled “Port Forwarding”
ParameterDescription
RulesNAT/port forward entries

MDM Agent

Section titled “MDM Agent”
ParameterDescription
Heartbeat IntervalAlive signal frequency
Telemetry IntervalMetrics report frequency
Remote AccessAdmin tunnel enable

Creating a Profile

Section titled “Creating a Profile”
  1. Navigate to Configuration → Profiles
  2. Click Create Profile
  3. Name the profile (e.g., “Fleet Standard Config”)
  4. Configure desired settings across all categories
  5. Save the profile

Deploying a Profile

Section titled “Deploying a Profile”

To a Single Device

Section titled “To a Single Device”
  1. Go to the device’s detail page
  2. Click Configuration → Apply Profile
  3. Select the profile
  4. Review changes that will be applied
  5. Click Deploy

To Multiple Devices

Section titled “To Multiple Devices”
  1. Go to Devices list
  2. Select target devices (checkboxes)
  3. Click Bulk Actions → Apply Profile
  4. Select the profile
  5. Review and confirm

By Tag/Group

Section titled “By Tag/Group”
  1. Navigate to Configuration → Deploy
  2. Select the profile
  3. Choose target: “All devices with tag X”
  4. Review the affected device list
  5. Click Deploy

Deployment Status

Section titled “Deployment Status”

After deploying a profile, monitor status:

StatusMeaning
PendingCommand queued, waiting for device
DeliveredMQTT message received by device
ApplyingDevice is processing changes
AppliedConfiguration successfully applied
FailedDevice rejected or couldn’t apply
TimeoutDevice didn’t respond in time

Configuration Sync

Section titled “Configuration Sync”

If a device and cloud get out of sync:

  1. Trigger a Config Sync from the device detail page
  2. The device exports its current configuration
  3. Platform compares with expected state
  4. Differences are highlighted for review
  5. Admin can push corrections or accept device state

Configuration History

Section titled “Configuration History”

Every configuration change is logged:

  • What was changed
  • Who initiated the change
  • When it was applied
  • Whether it succeeded or failed
  • Previous values (for rollback)