IT rollout
Install OpenChatly Capture on many Windows, macOS and Linux computers with one enrollment token. Each computer enrolls and records on its own, with no sign-in to OpenChatly, and you link it to a person when you want.
IT installs OpenChatly Capture, the separate recorder app, on every Windows, macOS or Linux computer with one command. The installer adds a machine service. At each sign-in the service enrolls the computer and starts recording. Nobody signs in to OpenChatly by hand, and nobody needs an OpenChatly account. The service restarts the recorder within seconds when it stops.
This page is for the IT team and the OpenChatly workspace admins. For one person on their own computer, see Capture → Install OpenChatly Capture.
How it works
- A workspace admin creates an enrollment token in OpenChatly.
- IT installs
KortixCapture-x64.msion each computer with the OpenChatly URL and the token. The installer writes both to the registry and starts the OpenChatly Capture Windows service. - At each Windows sign-in the service reads the person’s Windows sign-in
name (the user principal name, for example
jane@corp.example) and enrolls the computer with the token. - The computer gets a device token and starts recording. It belongs to the workspace. A personal token links it to its person. Any other computer records linked to no one, which is a normal state: an admin links it to a person when that is wanted.
- The OpenChatly Capture icon in the notification area shows that it records. Nothing else interrupts the person. When the policy sets a notice, the person sees it once.
The service runs as LocalSystem. It starts the recorder in each signed-in
session as that person, and starts it again within seconds when it stops.
The enrollment token stays with the service: the registry key that holds it is
readable by SYSTEM and administrators only, and the person’s processes never
see it.
Before you start
- Turn on Capture for the workspace and set the policy: what is recorded, the frame rate, exclusions, retention and the notice the person sees. See Capture → The policy.
- People do not need OpenChatly accounts. A computer records for the workspace whether or not it is linked to a person. To link computers to members as they enroll, turn on Approve each computer: OpenChatly suggests the member with the computer’s sign-in email, and you confirm it.
- You need the
capture.managepermission. Workspace owners and admins have it.
1. Create an enrollment token
In OpenChatly, open OpenChatly Capture → Devices, then Company install. Create a token and fill in:
| Field | What it does |
|---|---|
| Name | A name for the token, for example the computer group. |
| For | Anyone at the company: one token for many computers. They enroll linked to no one; you link them, or confirm the suggested member with Approve each computer. A member: a personal token. Every computer it installs links to that person, whoever signs in. It stops working when that person leaves the workspace. |
| Email domains | Anyone tokens only. Only people who sign in to the computer with these domains enroll. Empty: anyone. |
| Computer limit | A cap in case the token leaks. A personal token starts at 1. Empty: no limit. |
| Valid for | 7, 30 or 90 days, or Never. Computers enrolled before it expires keep recording. |
| Approve each computer | Every new computer waits for an admin, also when its person is a member. |
OpenChatly shows the token (kortix_enr_…) once. Copy it with the install
command next to it. Anyone who has the token can enroll computers into the
workspace until you revoke it, so handle it like a password.
From the API: POST /v1/accounts/<account_id>/capture/enrollment-tokens with
{"name": "Pilot laptops", "email_domains": ["corp.example"], "max_devices": 20}.
For a personal token, add "user_id": "<member>": the member must belong to the
workspace, else the API answers 400 capture_enrollment_invalid.
2. Install on each Windows computer
On one computer, open Command Prompt as administrator and paste the line from Devices → Company install (the dialog Install on company computers). It downloads the installer, installs it silently, waits, checks that the OpenChatly Capture service exists, and prints whether it worked:
curl.exe -fsSL -o "%TEMP%\KortixCapture-x64.msi" https://github.com/kortix-ai/CompanyOS/releases/latest/download/KortixCapture-x64.msi && start /wait msiexec /i "%TEMP%\KortixCapture-x64.msi" /qn /l*v "%TEMP%\KortixCapture-install.log" KORTIX_URL=https://api.kortix.com ENROLLMENT_TOKEN=kortix_enr_... && sc query KortixCapture >nul 2>&1 && echo Kortix Capture installed. It records from the next Windows sign-in. || echo Install failed. Log: "%TEMP%\KortixCapture-install.log"
msiexec on its own returns at once and installs in the background, and with
/qn it shows no error, also when the MSI path is wrong. start /wait and the
log make the result visible. With the MSI next to the command (Intune, a
script), the short form is:
msiexec /i KortixCapture-x64.msi /qn KORTIX_URL=https://api.kortix.com ENROLLMENT_TOKEN=kortix_enr_...
KORTIX_URL is the address of your OpenChatly API without /v1. Self-hosted
OpenChatly uses its own API address. The installer marks ENROLLMENT_TOKEN as
hidden, so it does not appear in installer logs.
With Microsoft Intune, add the MSI as a line-of-business or Win32 app and use the command line above. With Group Policy or another tool, install the MSI without properties and write the two registry values yourself:
| Key | Value | Type |
|---|---|---|
HKLM\SOFTWARE\Policies\Kortix\Capture |
Url |
REG_SZ |
HKLM\SOFTWARE\Policies\Kortix\Capture |
EnrollmentToken |
REG_SZ |
An upgrade (msiexec /i with a newer MSI) keeps the registry values when you
pass no properties.
The installer never rolls back because the service did not start: it starts the service when it can, and Windows starts it about a minute after every boot. The MSI installs the Microsoft Edge WebView2 Runtime when a Windows 10 computer does not have it; the OpenChatly Capture window needs it. A person who double-clicks the MSI without properties gets the app opened at the end and signs in from it.
3. Check the rollout
Devices lists every enrolled computer with an IT rollout badge, under its person or under Linked to no one, with its live state: recording, paused, offline. A computer reports within a minute of the first Windows sign-in.
To link a computer to a person, choose Link to a person… on it. What it recorded linked to no one moves to that person. See Capture → Link a computer to a person.
Waiting for approval lists computers that wait for an admin: the token approves each computer, or an admin revoked this one. For each, choose Approve (and, if you like, the person it records for) or Deny. An approved computer starts recording within a minute.
On the computer:
sc query KortixCapture
Get-Process kortix-capture | Select-Object Id, SessionId
The service is RUNNING, and a kortix-capture process runs in each
signed-in session.
What Kortix Capture costs a computer
Kortix Capture runs below normal priority and, on Windows 11, in efficiency mode, so the apps a person works in always win the CPU. The keyboard and mouse hook never waits on Capture’s own work.
- With record only included apps (for example only the apps a team works in), Capture takes no screenshots, reads no text and walks no app’s accessibility tree while another app is in front.
- While a person works, Capture defers what can wait: text recognition reads each screen at most every 30 seconds, and video encoding waits for a pause (at most 5 minutes).
- Text recognition can be off. In Kortix, Capture → Settings → Screen frames → Text recognition → Off reads no screen text on any computer: the least CPU. Search then finds apps, window titles and URLs.
- On a slow computer, Capture slows itself down: a capture or a text read that takes longer is followed by a longer rest, so screen capture uses at most half and text recognition at most a fifth of one core.
- Device details in Devices shows what Capture used on each computer in the last 10 minutes: CPU (average and peak, as a share of one core), memory, and each Capture process.
Antivirus scans each new file. To keep that scanning off the recorder, exclude
the library folder %APPDATA%\ai.kortix.capture and the processes
kortix-capture.exe, kortix-capture-engine.exe and kortix-backend.exe
(Microsoft Defender: Intune → Endpoint security → Antivirus → exclusions).
Remove a computer or stop a rollout
| To | Do |
|---|---|
| Stop new computers from enrolling | Revoke the token in Company install. Enrolled computers keep recording. |
| Stop one computer | Revoke the device in Devices, or deny it in Waiting for approval. Its device token stops working at once. The computer does not enroll again until an admin approves it. |
| Remove OpenChatly Capture | msiexec /x KortixCapture-x64.msi /qn (the same MSI), or Settings → Apps → OpenChatly Capture → Uninstall. The service and the program files go away. Recordings on the computer stay in each person’s profile until retention deletes them. |
What the enrollment token can and cannot do
- It enrolls computers into one workspace, within its domains, limit and expiry. It cannot read anything.
- A device token, which each enrolled computer gets, uploads that computer’s recordings and reads the workspace’s policy. It cannot read recordings.
- The sign-in name a computer reports is not proof of who uses it: an administrator of that computer can change it. So the name never links a computer on its own. It is a suggestion you confirm under Approve each computer.
- An enrolled computer proves itself with its current device token when it enrolls again. A copy of its machine key alone gets a new token only after an admin approves it, for example after a reinstall.
- Every enrollment, token change and decision is in the workspace’s audit log:
capture.device.enroll,capture.enrollment_token.create,capture.enrollment_token.revoke,capture.enrollment.approve,capture.enrollment.deny,capture.device.link.
Answers from enroll
The service writes these answers to its log (%ProgramData%\Kortix\Capture\logs)
and asks again on its own.
| Answer | Means | The computer |
|---|---|---|
enrolled |
The token is valid. member names the linked person, or is null while the computer is linked to no one. |
records |
pending approval_required |
The token approves each computer, an admin revoked this one, or it asked for a new token without its current one. | waits; asks again every minute |
401 enrollment_token_invalid |
The token is unknown, revoked or expired. | asks again every hour |
403 enrollment_domain_not_allowed |
The sign-in domain is not one of the token’s. | asks again every 6 hours |
403 enrollment_limit_reached |
The token reached its computer limit. | asks again every hour |
403 enrollment_denied |
An admin denied this computer. | asks again every 6 hours |
403 capture_disabled |
Capture is off for the workspace. | asks again every hour |
macOS
IT writes the OpenChatly URL and the token to a root-only file, then installs the
package. The package installs Kortix Capture.app (Developer ID signed and
notarized), a machine service (LaunchDaemon) that holds the token and enrolls
each person who signs in, and an agent that records in every session.
sudo mkdir -p "/Library/Application Support/Kortix/Capture"
echo '{"url":"https://api.kortix.com","enrollment_token":"kortix_enr_..."}' | sudo tee "/Library/Application Support/Kortix/Capture/config.json" >/dev/null
sudo chmod 600 "/Library/Application Support/Kortix/Capture/config.json"
curl -fsSL -o /tmp/KortixCapture-universal.pkg https://github.com/kortix-ai/CompanyOS/releases/latest/download/KortixCapture-universal.pkg && sudo installer -pkg /tmp/KortixCapture-universal.pkg -target / && echo "Kortix Capture installed."
With an MDM, deploy the package and a configuration profile for the domain
ai.kortix.capture with the keys Url and EnrollmentToken. A profile is
readable by every user on the computer; use the root-only file when the token
must stay secret.
macOS asks the person to allow Screen Recording once. A Privacy Preferences
Policy Control (PPPC) profile can pre-approve Accessibility and Input
Monitoring for ai.kortix.capture; for Screen Recording it can only let a
standard user approve it. To remove OpenChatly Capture:
sudo "/Applications/Kortix Capture.app/Contents/Resources/uninstall.sh".
Linux
sudo install -d -m 755 /etc/kortix
echo '{"url":"https://api.kortix.com","enrollment_token":"kortix_enr_..."}' | sudo tee /etc/kortix/capture.json >/dev/null
sudo chmod 600 /etc/kortix/capture.json
curl -fsSL -o /tmp/kortix-capture_amd64.deb https://github.com/kortix-ai/CompanyOS/releases/latest/download/kortix-capture_amd64.deb && sudo apt-get install -y /tmp/kortix-capture_amd64.deb && echo "Kortix Capture installed."
The package installs a machine service (kortix-capture-machine) that holds
the token and enrolls each person who signs in to a graphical session, and a
user service that records in every session. OpenChatly Capture records X11
sessions; a Wayland session enrolls but records nothing yet. To remove it:
sudo apt purge kortix-capture.
Without the config file on macOS or Linux, each person chooses Sign in with OpenChatly… from the OpenChatly Capture icon (Capture → Install OpenChatly Capture).