Browse documentation

Adding a device

↩ Devices

There are two ways devices get into JOATOS: automatically through discovery, or manually when you want to add one yourself.

Two ways to add a device

Discovery — a subnet scan or vendor-controller query finds devices and adds them for you. This is the recommended way to add many devices at once.
Manual add — for a single device, or one that discovery can't reach.

Field	Notes
Name (required)	A friendly name, e.g. Core Switch 01.
Site (required)	The location it belongs to. The site's collector reaches it for monitoring.
Type (required)	Switch, Router, Firewall, Access Point, UPS, or Other — see Understanding device types.
Connection address	The IP address or hostname JOATOS uses to reach it.
Manufacturer	Often auto-detected from SNMP once polling starts.
Model	Often auto-detected from SNMP once polling starts.
Serial number	Used for asset linking and warranty lookup.
Status	Online, Offline, Unknown, or Maintenance. Set Maintenance to pause monitoring and suppress alerts.
ICMP profile	Controls ping / uptime monitoring.
Scanning profile	Defines how JOATOS polls the device — which credential, how often, and what to collect.
Location	Where it physically lives, e.g. Rack A2, U3. May be overwritten by the device's SNMP location.
Management URL	Link to the device's web admin page, shown on its detail page.
Notes	Free-form notes, shown on the detail page.

Adding a device records it, but to collect stats JOATOS needs to reach it:

Assign a scanning profile so the collector knows which credential and interval to use.
Assign an ICMP profile for ping-based up/down monitoring.
Make sure the device's site has a Site Collector assigned.

Once polling starts, fields like manufacturer, model, and firmware are filled in automatically where the device reports them.

The Type you choose determines which tabs and data appear later — pick the closest match.
To temporarily stop alerts for planned work, set the device Status to Maintenance rather than deleting it.