Cloud Organization Hierarchy
Viam fleet management allows you to organize, manage, and control any number of machines alone or in collaboration with others. You can manage and control your fleet of smart machines from the Viam app, using the CLI, or using the fleet management API.
Work with groups of machines
To organize your fleet you use:
The organization structure enables you to:
- configure groups of machines with reusable fragments that configure a set of resources for each machine that uses the fragment.
- deploy code packages or machine learning models, without manually copying files by uploading it to Viam’s cloud and deploying it to your fleet
- control a machine with code, the app’s CONTROL tab, or the Viam mobile app
- obtain health metrics, such as status, uptime, version, or logs
- perform debugging
All of this is possible when you are close to your machine, as well as remotely from anywhere in the world.
Use Viam for collaboration
When you create a Viam account, Viam automatically creates an organization for you. You can use this organization as your collaboration hub by inviting collaborators to your organization. You can also add additional organizations as desired at any time.
To facilitate collaboration, you can grant individual collaborators or entire organizations granular permissions for individual machines or entire locations. This allows you flexibility to manage internal machines, sell devices to external customers and keep managing them, and collaborate with different partners or companies on groups of machines. For more information, see Permissions.
Configuration
When you or your collaborators change the configuration of a machine or a group of machines in the Viam app, viam-server automatically synchronizes the configuration and updates the running resources within 15 seconds.
This means everyone who has access can change a fleet’s configuration, even while your machines are running.
You can see configuration changes made by yourself or by your collaborators by selecting History on the right side of your machine part’s card on the CONFIGURE tab. You can also revert to an earlier configuration from the History tab.
Simultaneous config edits
If you edit a config while someone else edits the same config, the person who saves last will overwrite any prior changes that aren’t reflected in the new config.
Before editing a config, we recommend you refresh the page to ensure you have all the latest changes.
Machine configuration and machine code is intentionally kept separate, allowing you to keep track of versioning and debug issues separately.
Next steps
To learn about configuring and provisioning many machines, see Deploy a Large Fleet.
To learn about monitoring and remotely controlling the machines in your fleet, see Control Interface.
Check out the following tutorial for an example of organizing a fleet into locations, configuring multiple machines, and syncing data from all of them:
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!