J
JOATOSIT Operations Platform
Browse documentation

Enrolling an endpoint

Endpoints

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

  1. An administrator creates an enrolment key (under Settings → Site Collectors).
  2. The agent is installed on the machine with that key — see Installing the Endpoint Agent.
  3. On first run the agent reads the machine's local identity (serial number, model, hostname, OS, network addresses) and enrols.
  4. 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:

ColumnShows
NameThe machine name (hostname, or an admin-set name)
HostnameReported hostname
Make & ModelFrom the linked asset, or the agent's reported hardware
TypeWORKSTATION or LAPTOP
OSOperating system and version
AgentAgent online/offline status and version
StatusOverall 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.

Related