Once a day the agent reports the computer's specifications (processor, memory, drives,
MAC address and so on) into the device card in the SmartOKS knowledge base. You install it once, and
everything after that happens automatically, including updates to the program itself.
What you need
The computer: Windows 10 or 11, internet access, and administrator rights to install.
(Windows 7 is not supported — for those machines use an HWiNFO/AIDA64 report on the device card.)
A phone (or another computer) with a camera, signed in to your organization's
SmartOKS as a user with edit rights (Manager or Administrator).
Organization plan: Education or Pro.
The knowledge base must already contain a device card of type "Desktop" or "Laptop"
at the relevant workstation (create it in advance if it is missing).
1 Install the agent on the computer
Download the installer: https://smartoks.com.ua/agent/SmartOKSAgent-Setup-0.1.2.msi(the version number in the file name may be newer).
Run the file. If a blue "Windows protected your PC" window appears, click
More info and then Run anyway.
This is the standard warning for new software without a code-signing certificate.
You can verify the file against the SHA-256 checksum published next to the installer.
Wait for it to finish (no questions asked, about half a minute). A SmartOKS icon with a
grey dot appears in the system tray, next to
the clock: the agent is running but not yet linked to a device card.
2 Open the linking window (on the computer)
Click the SmartOKS tray icon → Link to SmartOKS…
(or double-click the icon, or use Start menu → SmartOKS Agent).
Approve the administrator prompt (UAC) — Yes.
A window with a QR code appears. It is valid for 10 minutes; if it expires, use the
New code button.
The linking window on the computer screen (the QR code is an example). Below it is the same
code as text, which you can type in by hand if scanning is awkward.
3 Scan the code with your phone
On your phone, open your organization's SmartOKS
(organization-name.smartoks.com.ua) and sign in.
Go to Knowledge base → find the workstation → open the device card
("Desktop" or "Laptop") → the ⋮ menu →
Link SmartOKS Agent.
Allow camera access and point it at the QR code on the monitor —
or type the code into the field below.
Check that this really is the right computer (name, MAC address, motherboard)
and press Yes, link it.
Three steps on the phone. The check at step ② saves you from linking the wrong machine —
a single room can hold fifteen identical ones.
Within a minute or two the device card shows all the specifications and an
Agent · just now
badge — from now on they update themselves every time the computer starts.
The tray icon — what the colours mean
Dot on the icon
State
What to do
Green
All good, the agent is online
Nothing — it runs by itself
Grey
The computer is not linked to a card
Icon menu → "Link to SmartOKS…"
Orange
Action needed: the organization plan, or a restart pending after an update
Read the message in the icon menu
Red
Error connecting to the platform
Check the internet; menu → "Open logs"
The icon menu also has Send report now, which is handy right after a
hardware swap so you do not have to wait for the scheduled report.
Frequently asked questions
Is this safe? What does the agent send?
Nine hardware fields only (processor, motherboard, graphics, memory, drives, network card, MAC
address, PC name, Windows version). The agent does not collect files, installed software,
passwords or user activity, and it cannot execute commands from the server — it only reports.
It says "SmartOKS Agent is not available on the Free plan"
The agent is available on the Education and Pro plans — talk to your organization's administrator.
The code will not scan, or the phone has no camera
Type the code in by hand — the field sits directly under the camera view. Format: K7M3-9PQR.
The code has "expired"
A code lives for 10 minutes. In the window on the computer press "New code" and scan again.
How do I move the agent to another card, or switch it off?
On the device card: the ⋮ menu → "Unlink SmartOKS Agent". The agent on the computer clears its own
link and keys. To remove it completely, use "Apps & features" → SmartOKS Agent.
How does the program update?
By itself: once a day it checks for a new version and installs it quietly. Nothing for you to do.
We are on Windows 7
The agent runs on Windows 10/11 only. For older machines use the "Import from an HWiNFO / AIDA64 report"
button on the device card — the specifications are filled in from the report file.