Skip to main content

Platform Configure

What a platform's identity actually consists of — the enrollment fields set once at install, and the metadata reported continuously afterward. For the how-to of editing .env and restarting the service, see Enrollment. For how devices combine into a multi-device platform (master and children), see Platform Architecture.

Enrollment — set once, rarely changes​

Written at install time (via the MSI/RPM installer or .env), read once at startup:

FieldMaps toWhat it is
device_idDEVICE_IDThe device's unique identifier
device_typeDEVICE_TYPE_TOKENOne or more device-type tokens
platform_idPLATFORM_TYPE_IDThe platform's unique ID
platformPLATFORM_TYPE_TOKENThe platform's name/token
url_get_app_server_availableBASE_URL (plus fallbacks)The GetApp server URL(s) this agent can reach
delivery_source—Delivery source mode
orchestrate_me—When true, requests a master agent orchestrate this device (A2A)

See Enrollment for editing these via .env, and Package Bundles for setting them at install time via MSI/RPM properties.

Metadata — reported continuously​

Gathered live from the device and sent on every discovery/heartbeat, not something you set by hand:

FieldWhat it is
mac_address / ip_addressNetwork identity
nameDevice display name
locationGeolocation, when available
os / os_releaseOperating system and version
storage_availableFree disk space
batteryBattery status, on battery-powered devices
bandwidthMeasured upload/download throughput
versionsInstalled agent/agent-UI version strings
miscFlattened, agent-specific extra fields

This is the same metadata the Platform Table and Platform Information drawer show on the server side — enrollment identifies the platform once, metadata is what keeps its picture on the server current.

See also​