Organize your machines
Before you start connecting your devices to the Viam app, you need to decide how you want to group your machines.
In the Viam app, 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. You cannot move machines to other locations once created.
Create organizations and locations
Create organizations
- Log into Viam app in a web browser.
- 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.
- Create additional organizations as needed.
Create locations
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.
Create additional locations as needed using the Add location button, on the left of the LOCATIONS page.
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:
- Add a new location using the same Add location button.
- 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?
No, it is not possible to move a machine to a different location.
If you want to have the machine in a different location, you will need to create a new machine and copy the old machine’s configuration to the new machine.
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.
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better:
Thank you!