Deploy a large fleet

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:

A diagram showing how organizations, locations, and machines are grouped by Viam's fleet management

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 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 Part history page.

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 Viam mobile app allows you to:

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

apple store icon google play store icon

Next steps

Check out the following tutorial for an example of organizing a fleet into locations, configuring multiple machines, and syncing data from all of them: