NetLock RMMNetLock RMM Docs
III — How-To Guides

Create your first tenant, location, and group

Build the three-level organisational hierarchy every device lives in.

Create your first tenant, location, and group

NetLock RMM organises every device into a three-level hierarchy: tenant → location → group. A device cannot be approved into the console without one of each. This guide walks through creating the hierarchy from scratch on the Tenants page. Once finished you will have an empty tree ready to receive an agent.

Tenants page with one new tenant visible

Before you start

  • You are signed in to the Console as a user with permission to manage tenants.
  • Required permissions: tenants_enabled, tenants_add, tenants_manage, tenants_locations_add, tenants_locations_manage and tenants_groups_add.

Steps

Create the tenant

  1. In the navigation, open Tenants.
  2. Click Add above the tenant table. While no tenant exists, the page shows Create Tenant instead.
  3. Enter the tenant name and, if you like, a description, the company and contact persons. For an in-house IT team the tenant usually maps to the company; for an MSP it maps to one customer.
  4. Click Confirm. The new tenant appears in the list. It does not contain any locations, groups or devices yet.

Create the location

  1. Open the new tenant with the row action Manage (or double-click the row). The Manage tenant page opens.
  2. Click Add location above the Locations table.
  3. Enter a location name. Locations usually reflect a physical site, for example Berlin HQ, Remote Workers or Datacenter A.
  4. Click Confirm.

Create the group

  1. In the Locations table, open the new location with the row action Manage. The Manage location page opens.
  2. Click Add above the Groups table.
  3. Enter a group name aligned to how the devices inside it will be configured, for example Workstations, Laptops, Servers or POS Terminals. As a rule of thumb, create one group per intended policy.
  4. Click Confirm.

Tip: If a single policy applies to every device at a location regardless of role, one group per location is plenty. Only split groups when different policies will apply. It is easier to add groups later than to consolidate them.

Verify it worked

  • Tenants lists the new tenant.
  • Manage tenant for that tenant lists the new location under Locations.
  • Manage location for the new location lists the new group under Groups.

Troubleshooting

  • An Add button or the Manage action is missing. Your user account is missing the matching permission from the list above. Ask an administrator to grant it.
  • A name is rejected with Name already taken. Tenant names are unique across the installation, location names within their tenant, and group names within their location. Pick a different name or a different parent.