retivo Docs
  1. Docs
  2. Tasks

Add devices

One at a time, from a CSV file, or by scanning a subnet.

Before you begin

  • You need the Edit devices permission.
  • Save at least one SSH and one SNMP credential under Inventory > Credentials.

Add one device

  1. Inventory > Devices > Add device.
  2. Enter the name, the IP address or host name, and the platform.
  3. Choose credentials, or leave them empty to use the group's.
  4. Tick the groups it belongs to and save.

Retivo checks the device within a minute and reads its model, serial and OS version.

Import many from a CSV file

  1. Inventory > Devices > Import and download the template.
  2. Replace the example rows with your devices and save as CSV.
  3. Upload it. Every row is checked first; nothing is created until all rows are valid.

The columns are:

Column Example Notes
name core-sw-01 Required, unique
host 10.0.0.2 Required: IP address or host name
platform cisco_xe Required; see Supported platforms for the IDs
model Catalyst 9300 Optional; read from the device later anyway
location HQ rack A3 Optional
ssh_port 22 Optional
groups HQ|Core Group names separated by |
ssh_credential, snmp_credential net-admin Credential names; empty means the group's
use_ping, use_snmp, use_lldp, use_cdp, backup yes yes or no

Discover a subnet

  1. Inventory > Discover.
  2. Enter a subnet up to a /22, for example 10.0.10.0/24, and press Scan. Every saved SNMP credential is tried on each address.
  3. Tick the devices to add (devices already in Retivo cannot be ticked), choose a group and press Add.

Use the names the devices report

When a device's own name differs from its name in Retivo, the inventory shows it underneath. Tick devices and press Use system names, or press Use system name on a device page. Retivo shows the new names first, and skips devices whose system name is unknown or already taken.

Export the inventory

Press Export, choose which devices (ticked, the current filter, a group, a vendor or all) and tick the columns you want: status, model, serial, OS version and support date, groups, storage, uptime, last backup, CVE counts and more. Your choice is remembered.

What's next

Last modified October 15, 2026