Connecting Your First Device to IZI
यह कंटेंट अभी तक आपकी भाषा में उपलब्ध नहीं है।
Connecting Your First Device to IZI
Section titled “Connecting Your First Device to IZI”For IZI to start managing a computer in the hall — recording sessions, applying tariffs, managing working time — the IZI agent (client application) is installed on each PC and registered in the CRM with a pairing code (pairing is the one-time process of linking a physical machine to your club and zone). The whole process takes about five minutes per machine: download the installer right from the CRM, run it on the PC, enter the nine-digit code. After that the device appears in the equipment list and starts accepting players. A pairing code is valid for 4 hours and is reusable — you can connect the whole hall one machine after another with one code, without regenerating it. If the club plans to use network boot from a central image, a separate paid product, IZI Boot, is connected after the agents are registered.
Prerequisites
Section titled “Prerequisites”- The club is created in IZI.
- At least one zone is set up — you choose it while installing the agent.
- The employee doing the connection has the Create device pairing codes permission (
DEVICE_PAIRING_CODE_CREATE) in the club role settings. - The PC runs Windows (the agent installs only on Windows; PlayStation and Xbox use the Console type, VR and other equipment without IZI software use the Custom type — both without installing the agent).
Step 1 — Generate a pairing code in the CRM
Section titled “Step 1 — Generate a pairing code in the CRM”- Open the CRM and select the club.
- Open Settings → Equipment → Devices.
- Click Add device.
- In the window that opens, choose the PC type.
- The CRM shows a pairing code in the
000-000-000format and a link to download the installer. The code is valid for 4 hours and is reusable.
If you need a new code (the previous one expired or was given to someone else), click Regenerate — the old code is then cancelled.
Step 2 — Install the agent on the PC
Section titled “Step 2 — Install the agent on the PC”- On the PC in the hall, download the installer using the link from the CRM.
- Run the installer with administrator rights.
- During installation, enter:
- Pairing code — the nine-digit code from the CRM (
000-000-000format). - Zone — choose from the list (the agent loads the list of zones by the code).
- Device name — digits only, no more than 4 characters (for example:
1,42,1001).
- Pairing code — the nine-digit code from the CRM (
- Finish the installation. The agent registers the PC in the club and receives an access token.
After that the device appears in the CRM in the Equipment section with the status Online.
Step 3 — Check the device status in the CRM
Section titled “Step 3 — Check the device status in the CRM”In the Equipment section, make sure that:
- The device is shown in the list.
- The status is Online (the agent has connected to the server).
- The zone and name match what was entered during installation.
If the device has not appeared within a minute, check that the PC has internet access and the pairing code has not expired.
Console and Custom types — devices without the agent
Section titled “Console and Custom types — devices without the agent”For PlayStation and Xbox, choose the Console type when adding the device and specify the platform. For other equipment without Windows (VR headsets, emulators, simulators), choose the Custom type. Both types are registered in the system without installing software, are linked to a zone manually and are managed through the CRM — the cashier starts and stops the session manually.
Device names: rules
Section titled “Device names: rules”| Parameter | Requirement |
|---|---|
| Format | Digits only (0-9) |
| Length | 1 to 4 characters |
| Examples | 1, 12, 101, 1001 |
| Uniqueness | Unique within the club, including deleted devices |
IZI Boot — network boot from a reference image
Section titled “IZI Boot — network boot from a reference image”IZI Boot is an advanced module for clubs that need to manage the OS images of all PCs centrally. After setup, each PC boots from a reference disk over an iSCSI connection to a TrueNAS server. This removes the need to reinstall Windows manually on each machine — it is enough to update one reference image, and IZI rolls it out to the whole fleet automatically.
What you need
Section titled “What you need”- A TrueNAS server (version 25.04 or later recommended) on the club’s local network.
- The TrueNAS REST API is enabled, and an API token is created with permissions to manage datasets and iSCSI.
- At least one PC in the club is already registered as a device in IZI.
How to set up IZI Boot
Section titled “How to set up IZI Boot”IZI Boot settings are in the Equipment → IZI Boot section of the club CRM.
Step 1. Connect TrueNAS
Click Set up IZI Boot and fill in the fields:
| Field | What to enter |
|---|---|
| Protocol | HTTP or HTTPS — as configured in TrueNAS |
| IP | IP address of TrueNAS on the club’s local network |
| Port | TrueNAS REST API port (usually 80 or 443) |
| API token | Token from TrueNAS → System → API Keys |
| TrueNAS local IP | LAN address for the PCs’ iSCSI connection (if it differs from the external one) |
| Drive letter | The letter (A–Z, except C) under which the LUN will be visible on each PC |
| TrueNAS pool | Pool name (for example main); if there is one pool, it is detected automatically |
Click Save. The CRM checks the connection — on success, a notification appears that the storage connection has been verified.
Important: the drive letter C is reserved for the system disk. If you change the letter after saving, IZI Boot is reinstalled on all club PCs and they reboot.
Step 2. Choose the Boot PCs
In the Boot PCs section, select the devices that should boot from the reference image and click Save. The system updates the list: the number of enabled, disabled and skipped devices is shown in the notification.
To turn IZI Boot off on specific PCs, clear their checkboxes and save. IZI automatically deletes their boot storage (the clone and the iSCSI target). Local changes on those disks are lost.
Step 3. Capture a reference image
After connecting TrueNAS and choosing the PCs, make the first reference image from a configured machine:
- For the reference PC, manually create a zvol in TrueNAS and set up iSCSI (once), then install Windows and the required programs.
- In the CRM, click Create reference image and choose this PC.
After that the image appears in the IZI Boot status with its capture date and the name of the source PC. All other club PCs receive a clone of this image automatically at the next provision.
IZI Boot status
Section titled “IZI Boot status”After setup, the IZI Boot section shows:
| Field | What it shows |
|---|---|
| Endpoint | http(s)://IP:port of TrueNAS |
| TrueNAS pool | Name of the pool where images are created |
| Reference image | Capture date and source PC name (or No reference captured yet) |
If the TrueNAS version is outdated (below 25.04), the CRM warns about it in the status.
Scheduled auto-update
Section titled “Scheduled auto-update”In the IZI Boot settings you can turn on Scheduled auto-update: IZI will roll the new image out to the PCs automatically. The update is applied only after the current session ends — it does not interrupt players who are playing.
Next steps
Section titled “Next steps”After connecting the first devices:
- Create tariffs — without tariffs the cashier cannot open a session.
- Set up zones if the hall is divided into segments with different prices.
- Review the initial setup checklist — what else needs to be done before opening.
अक्सर पूछे जाने वाले सवाल
What do I need to do first to add a device to IZI?
Make sure the club is created, at least one zone is set up, and the employee has the Devices permission in the role settings. Then go to the Equipment section, click Add device and follow the instructions.
Can I connect a PlayStation, Xbox or VR headset?
Yes. PlayStation and Xbox have their own device type, Console (you choose the platform). VR headsets and other equipment without IZI software are registered with the Custom type. Both types work without the agent and are linked to a zone the same way as regular PCs.
How long is a device pairing code valid?
A pairing code is valid for 4 hours from the moment it is generated. It is reusable — one code can be used for several PCs in a row until it expires.
What is IZI Boot and why do I need it?
IZI Boot is a module for network-booting PCs from a reference image via TrueNAS and iSCSI. It lets you roll a clean Windows out to all club machines with one command, without reinstalling manually. It is configured in the Equipment → IZI Boot section of the CRM.
What should I enter in the IP, Port and Protocol fields when setting up IZI Boot?
Enter the address of your TrueNAS server on the local network, the REST API port (usually 80 or 443), and choose HTTP or HTTPS depending on how TrueNAS is configured.
What is the API token in IZI Boot?
The API token is an access key created in the TrueNAS interface (System → API Keys). IZI uses it to manage datasets and iSCSI targets and to capture reference images. The token is hidden in the CRM after saving.
What is the drive letter in the IZI Boot settings?
The drive letter (for example D or E) is the letter under which the boot LUN is attached to each PC. The letter C is reserved for the system disk. If you change the letter after setup, IZI Boot is reinstalled on all club PCs with a reboot.
What is a reference image in IZI Boot?
A reference image is a snapshot of the disk of a PC configured as the standard: a clean OS, the required games and programs. IZI Boot clones this image to all other club PCs through TrueNAS. After the first setup, the image appears in the IZI Boot status with its capture date.
Can I roll back changes if something goes wrong during connection?
The Disconnect button in the IZI Boot status removes the club's storage configuration but does not touch images already created in TrueNAS. The agent configuration on the PCs has to be removed manually.
IZI LLC (ООО «ИЗИ»), TIN 7842227686, OGRN 1257800012249, office 1, premises 3-N, lit. A, 15-17 Perekupnoy lane, Saint Petersburg, 191024, Russia, admin@izi.is · Cookie settings