Device UUID in IZI CRM
Device UUID in IZI CRM
Section titled “Device UUID in IZI CRM”UUID (Universally Unique Identifier) is a code IZI generates when you add a device in the CRM. You copy it once, paste it into the agent installer on the physical PC, and from that moment the machine is permanently tied to its record in the system. The IZI client (the per-PC agent installed via the IZI installer) uses this UUID to identify itself every time it connects to the server — DHCP may reassign the IP after a reboot, but the UUID never changes. In the Devices section of the CRM each PC is shown with its name, zone, and online status; UUID is the internal key behind that record. For a step-by-step walkthrough of adding a PC and entering the UUID during installation, see Connecting computers to IZI.
Why UUID matters
Section titled “Why UUID matters”A typical club has dozens of PCs on one network. The system needs a rock-solid way to tell them apart:
- IP address — changes whenever DHCP reassigns it.
- Hostname — can be duplicated across machines.
- MAC address — changes when the network card is replaced.
UUID solves this permanently. What it enables in practice:
- Stable binding — the CRM always knows which physical machine corresponds to “PC-14 in the VIP zone.”
- Remote control — commands (power on, shutdown, reset disk protection) are routed to the exact device by UUID.
- History and analytics — sessions, revenue, and utilization are tracked per device, not per temporary network address.
- Hardware upgrades — when you repair or upgrade a PC, reinstall the agent with the same UUID and the device keeps its full history without any reconfiguration.
How a UUID enters the system
Section titled “How a UUID enters the system”- An admin creates a new device record under Hall → Devices in the CRM.
- IZI generates a UUID for that record automatically.
- The UUID is copied and entered during agent installation on the physical PC.
- On first launch the agent connects to the server — the CRM shows the device as online.
The UUID is created once and never changes for the lifetime of that device record in the system.
UUID vs. other identifiers
Section titled “UUID vs. other identifiers”| Identifier | What it is | Can it change? |
|---|---|---|
| IZI device UUID | Internal CRM record key | No |
| IP address | Network address of the PC | Yes (unless static) |
| MAC address | Hardware address of the network card | On card replacement |
| Hostname | Windows machine name | Yes |
Related
Section titled “Related”- Connecting computers to IZI — step-by-step agent installation with UUID entry
- Devices — managing PCs in the Hall section of the CRM
- DHCP and static IP — why the IP changes but the UUID does not
- IZI Boot — the server-side product (TrueNAS) that delivers games and disk images to club PCs over the network
Frequently asked questions
What is a device UUID in IZI?
UUID (Universally Unique Identifier) is a code IZI generates when you create a device record in the CRM. You enter it during agent installation on the physical PC, permanently linking that machine in the hall to its CRM record. Every UUID is globally unique — no two devices across any club share the same value.
Where do I find a device UUID in IZI CRM?
The UUID is shown in the Devices section of the CRM, inside each PC's card. When you create a new device, IZI generates the UUID automatically and prompts you to copy it for use during agent installation.
What happens if I enter the wrong UUID during agent installation?
The IZI agent will either fail to connect to the CRM or bind to the wrong device record. The machine will appear offline or be mixed up with another PC. The fix is to reinstall the agent using the correct UUID from the device card in CRM.
Do I need a new UUID if I replace the motherboard or hard drive?
No. The UUID lives in the IZI agent's configuration, not in the hardware. After replacing components and reinstalling the agent, use the same UUID from the existing device card. There is no need to create a new device record, and the full session history is preserved.