Bundles
A bundle is a named group of devices that share one deployed application. You create a bundle, add devices to it, and deploy a blueprint to it — and every device in the bundle runs that application.
Why a bundle is required
An application is always deployed to a bundle, never to an individual device. A device that is not in a bundle can never run one — no matter how it was registered or how healthy its connection is.
This is why bundles exist rather than being an optional grouping feature: they are the unit that deployment targets. If you have a single board, put it in a bundle of one. That is the expected pattern, not a workaround.
The payoff is what happens on the way up. A device added to a bundle that already has an application receives that application immediately and automatically. Going from one device to a thousand does not mean deploying a thousand times — it means adding devices to a bundle that is already running.
Create a bundle
Click Bundles in the sidebar
Click New Bundle
Enter a name and click Save
A bundle takes a name and nothing else. Name it after what the devices do or where they are —
cold-storage, line-2-sensors — because this is the name you will pick from when you deploy.
Add a device to a bundle
The same action is available from the other direction: open a device from the Devices list and set its bundle there. Both reach the same result, so use whichever screen you are already on. When you register a device you can also pick its bundle on the registration form, which skips this step entirely.
If the bundle already has an application deployed, the device starts running it right away.
One bundle per device
A device belongs to at most one bundle. Adding a device that is already in another bundle moves it rather than sharing it.
Moving a device to a different bundle prompts you to confirm. On confirming, the device leaves its old bundle and stops running that bundle’s application, then picks up the new bundle’s application instead.
What deploying to a bundle means
Deployment happens in the Blueprint Editor: Build & Deploy compiles the current blueprint and pushes it to a bundle you select. See Build & Deploy.
Two things follow from the bundle being the target:
- One application runs at a time. Deploying again replaces what the bundle’s devices are running.
- Deployment history is kept. The bundle page lists past deployments, which is what you roll back to when a new version misbehaves.
Deleting a bundle
A bundle can be deleted at any time, including while devices are in it and an application is deployed.
Deleting a bundle does not delete its devices. They remain registered to your company and keep reporting their connection status — but the application stops, and they cannot run one again until they are added to another bundle.
Bundles beyond deployment
A bundle is also a data source. When configuring a dashboard widget you can point it at a whole bundle instead of a single device, so one widget covers the fleet. See the Widget reference.
Bundles and device tags
The two look similar and do different jobs. A bundle decides which application runs on a device. A device tag differentiates devices within a bundle — so a single application can behave differently per device without splitting the fleet into more bundles.
Who can manage bundles
Creating bundles, adding devices, and deleting bundles requires the Owner or Admin role. Employees with the User role have read-only access.