Browse documentation
Enrolling an endpoint
An endpoint appears in JOATOS when the Endpoint Agent is installed on a machine and enrols itself. This article covers what happens after enrolment and how endpoints are listed.
How enrolment works
- An administrator creates an enrolment key (under Settings → Site Collectors).
- The agent is installed on the machine with that key — see Installing the Endpoint Agent.
- On first run the agent reads the machine's local identity (serial number, model, hostname, OS, network addresses) and enrols.
- JOATOS tries to match the machine to an asset by serial number. If it matches, the endpoint links to that asset automatically; if not, it goes to the review queue.
Reinstalling the agent or re-imaging the machine reconciles to the existing record — it won't create a duplicate.
The Endpoints list
Select Endpoints in the sidebar. Each row is a machine, with these columns:
| Column | Shows |
|---|---|
| Name | The machine name (hostname, or an admin-set name) |
| Hostname | Reported hostname |
| Make & Model | From the linked asset, or the agent's reported hardware |
| Type | WORKSTATION or LAPTOP |
| OS | Operating system and version |
| Agent | Agent online/offline status and version |
| Status | Overall online/offline/unknown state |
Rows are clickable — select one to open its detail page.
Filtering
Narrow the list by:
- Search — name, hostname, or model
- Type — Workstation or Laptop
- Status — Online, Offline, or Unknown
- Agent status — Agent online or offline
- Site
A Needs review stat card shows how many enrolled machines are waiting in the review queue; select it to jump there.
How endpoints are classified
The Type is decided from the machine's detected operating system at enrolment:
- A client OS (Windows 10/11, macOS) becomes a Workstation, or a Laptop if it's a portable.
- A server OS is treated as a server and appears under Servers instead.
You can override the type at any time — see Reclassifying an endpoint.
Notes & tips
- Endpoints self-report on a heartbeat, so there's no "scan now" button — data refreshes as the agent checks in.
- The Status reflects recent heartbeats; a machine that's been off or offline shows accordingly.