Skip to content

Device Batches

When you need to provision or deprovision more than one device at a time, the dashboard runs the job as a background batch. A batch can contain up to 100 devices.

When a Batch Is Created

A batch is created automatically when you set the Device count to more than one in the Add device dialog on the Devices page. The dialog adapts when you increase the count:

  • Generated device name becomes Name prefix. Each device in the batch is named <prefix>-001, <prefix>-002, etc.
  • The submit button changes from Create device to Create batch.
  • A notice appears: "This will create a background batch and take you to its progress page."
  • The selected network, firewall group, apps, peer-isolation setting, and dashboard-access setting apply to every device in the batch.

Bulk deprovisioning (selecting multiple devices and decommissioning them) also creates a batch.

Tracking Progress

After you click Create batch, the dashboard navigates to the batch detail page. You can also find all batches from the Batches link in the main navigation.

Batch List

The list shows one row per batch with the following columns:

ColumnDescription
Actionprovision or deprovision
StateOverall batch state (e.g. completed, in-progress)
ItemsTotal number of devices in the batch
ProcessedHow many devices have been processed so far
SuccessNumber of devices that completed successfully
FailedNumber of devices that failed
UpdatedTimestamp of the last state change

Click Open to view the detail page for any batch. Use Refresh to fetch the latest state. You can cancel a queued or running batch; items that have already completed are not rolled back.

Batch Detail

The detail page has two sections:

Batch summary — a card showing the action, state, item count, processed count, success count, failure count, name prefix, peer-access posture for provisioning batches, and last updated timestamp.

Items table — one row per device with:

ColumnDescription
#Sequence number in the batch
NameThe generated device name
DeviceLink to the device detail page (available once provisioning completes)
StatePer-device state (e.g. completed, failed)
ErrorError details if that device failed

Partial Failures

If some devices in a batch fail while others succeed, the batch still completes. The Failed count in the summary tells you how many did not provision successfully, and the Items table shows per-device errors so you can investigate.

Successfully provisioned devices are usable immediately. There is no retry button for failed batch items. Review each error, correct the cause, then provision replacements individually or create another batch with a new, non-conflicting name prefix.

Download Bootstrap Commands

After a provisioning batch completes, select Download ZIP. The archive contains the per-device bootstrap material needed to start each agent.

The download is temporary and its expiry is shown in the dashboard. Download it promptly, keep it encrypted at rest, and distribute each command only to its intended device. If the export expires before you retrieve it, decommission the unused device records and provision replacements; bootstrap commands are not recoverable from ordinary device details.