Fleet Templates
Fleet templates let you save a configuration as a reusable template and apply it to multiple instances with a single action. This ensures consistent configuration across your fleet and simplifies provisioning new instances.
Fleet templates require the fleet_templates license feature (Business+ plan).
Creating a Template
- Navigate to Fleet > Templates from the sidebar
- Click Create Template
- Enter a name and description
- Define the configuration as a JSON object (or YAML that gets stored as JSON)
- Click Save
Templates are versioned — each update increments the version number.
Applying a Template
- Open a template from the list
- Click Apply to Instances
- Select the target instances (individually or by group/tag)
- Click Apply
The configuration is pushed to each selected instance via the command delivery system. You can track the application status for each instance.
Application Status
| Status | Description |
|---|---|
| Pending | Template queued for delivery |
| Applied | Configuration successfully applied on the instance |
| Failed | Application failed (check instance logs for details) |
Template API
| Endpoint | Method | Description |
|---|---|---|
/api/fleet/templates | POST | Create a new template |
/api/fleet/templates | GET | List all templates |
/api/fleet/templates/{id} | PUT | Update a template (increments version) |
/api/fleet/templates/{id}/apply | POST | Apply template to instances. Body: {instance_ids: [...]} |
/api/fleet/templates/{id}/status | GET | View application status per instance |