Organize your machines

Before you start connecting your devices to Viam, you need to decide how you want to group your machines.

On Viam, machines are grouped into locations, and locations are grouped into organizations:

  • Each location can represent either a physical location or some other conceptual grouping like “Production” and “Testing”.
  • An organization is the highest level grouping, and often contains all the locations (and machines) of an entire company.

These groupings allow you to manage permissions; you can grant a user access to an individual machine, to all the machines in a location, or to everything in an entire organization. You choose how to group your machines.

Two locations within an organization

Create organizations and locations

1

Create organizations

  1. Log into Viam in a web browser.
  2. Click the dropdown in the upper-right corner of the FLEET page and use the + button to create a new organization. Name the organization and click Create.
  3. Create additional organizations as needed.
2

Create locations

  1. Click FLEET in the upper-left corner of the page and click LOCATIONS. A new location called First Location is automatically generated for you.

    Use the … menu to edit the location name to what it represents for your use case. Then click Save.

  2. Create additional locations as needed using the Add location button, on the left of the LOCATIONS page.

3

Create sub-locations

If needed, you can add further sub-locations to, for example, differentiate groups of machines within an office.

To add a sub-location:

  1. Add a new location using the same Add location button.
  2. At the bottom of the location’s page, use the New parent location dropdown to choose a parent location. Click Change.

You can nest locations up to three levels deep.

Example

If you’d like to look at an example, see Monitor Air Quality with a Fleet of Sensors.

Frequently asked questions

Can I move a machine to a different location?

Yes, organization owners and location owners can move machines between locations within their organization.

To move a machine:

  1. Navigate to your machine’s page.
  2. Click the … button in the upper-right corner.
  3. Select Move to a new location.
  4. Choose the destination location from the organization tree.
  5. Confirm the move.

Requirements for moving machines:

  • You must be an organization owner, or an owner of both the current and destination locations
  • The destination location must be within the same organization
  • No other machine in the destination location can have the same name

Can I move a location to a different organization?

No, it is not possible to move a location to a different organization.

You can share a location with another organization. However, machines will continue to use the primary organization as a reference point. This means any captured data is associated with the primary organization and the machines are only able to use private ML models and registry items from the primary owner.

Can I rename my organization after its creation?

Yes, you can rename your organization if you are an organization owner.

  1. Click the organization name in the upper-right corner of the FLEET page and click on Settings and invites.
  2. Find the Details section of the page.
  3. Change the organization name and click on the Rename button.

How do I delete an organization?

  1. Delete all the locations in your organization.
  2. Click the organization name in the upper-right corner of the FLEET page and click on Settings and invites.
  3. At the bottom of the page click Delete organization.