Fleet Management

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 cloud API.

Work with groups of machines

To organize your fleet you use

  • organizations: the highest level grouping, generally used for different companies.
  • locations: virtual groupings of devices up with up to three levels of nesting that can represent a grouping of machines that are co-located in a building, like a factory, or a grouping of machines that are thousands of miles apart and are grouped together by function or as an organizational unit.
  • smart machines: a grouping of components and services across one part, or multiple parts working closely together to complete tasks. Each machine resides in a location.

An image of two locations, New York, and Chicago, in one organization, Good Robots

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.


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 on the History tab. You can also revert to an earlier configuration from the History tab.

Machine configuration and machine code is intentionally kept separate, allowing you to keep track of versioning and debug issues separately.

The Viam mobile app

In addition to the Viam app, the fully featured web application where you can access all fleet management tools, there is a Viam mobile app. The mobile app is a convenient way to see if your machine is online, access the control interface, modify organization access, check machine logs, and upload images to the cloud.

You can find the mobile app on the App Store and on Google Play.

apple store icon google play store icon