hawkbit/docs/features.md

Features

---

Device and Software Repository

• Repository that holds the provisioning targets and assignable software distributions.
• Targets can be logically grouped by Target Types.
• Includes a full software update history for every device.
• Supports pre-commission devices in the repository and plug and play (device is created when it authenticates for the first time).

---

Update Management

• Directly deploy a defined software distribution to a device (via Management API).
• Update handling is independent of device type, integration approach, or connectivity.
• Optional user consent flow: download and install updates only after the respective end user has confirmed it.
• Mass cancel distribution of an update by invalidating the distribution set.
• Use action status codes for easier analysis.

---

Artifact Content Delivery

• Partial downloads supported.
• Download resume supported (RFC7233).
• Content management by RESTful API and UI.
• Authorization based on software assignment (a device can only download what was assigned to it).
• Delta artifact hosting supported.
• Artifact signature hosting supported.
• Plug-point for artifact encryption (allows encryption of artifacts on upload).

---

Rollout [Campaign] Management

• Secure handling of large volumes of devices at rollout creation time.
• Flexible deployment group definition as part of a rollout.
• Monitoring of rollout progress.
• Emergency rollout shutdown in case of update failures.
• Manually trigger the next rollout group.

---

Interfaces

Management API

• RESTful API.
• Create/Read/Update/Delete operations for provisioning targets (devices) and repository content (software).
• Manage and monitor software update operations.
• Online API documentation.
• JSON payload with Hypermedia support.
• Supports filtering, sorting, and paging.

Direct Device Integration API

• RESTful HTTP-based API for direct device integration.
• JSON payload.
• Traffic optimized (content-based ETag generation, not modified).
• Feedback channel from device.
• TLS encryption.

Device Management Federation API

• Indirect device integration through a device management service or application into hawkBit.
• Optimized for high service-to-service throughput with AMQP messaging interface.
• Separate AMQP vHost per tenant for maximum security.