Eclipse hawkBit™ - Update Server

Eclipse hawkBit is an domain independent back end solution for rolling out software updates to constrained edge devices as well as more powerful controllers and gateways connected to IP based networking infrastructure.

Build:

Documentation

see hawkBit Documentation

Contact us

• Want to chat with the team behind hawkBit?
• Having issues with hawkBit? Open a GitHub issue.
• You can also check out our Project Homepage for further contact options.

hawkBit sandbox

We offer a sandbox installation that is free for everyone to try out hawkBit. However, keep in mind that the sandbox database will be reset from time to time. It is also not possible to upload any artifacts into the sandbox. But you can use it to try out the Management UI, Management API and DDI API.

https://hawkbit.eu-gb.mybluemix.net/UI/

Compile, Run and Getting Started

We are not providing an off the shelf installation ready hawkBit update server. In addition we have guide for setting up a complete landscape.

Docker support by means of ready to go images is currently missing but we will look into this as soon as we can.

API stability

hawkBit is currently in '0.X' semantic version. That is due to the need that there is still content in hawkBit that is in need for refactoring. That includes the maven module structure, Spring Boot Properties, Spring Boot auto configuration as well as internal Java APIs (e.g. the repository API ).

However, the external APIs (i.e. Management API, DDI API, DDI Artifact Download API and DMF API are on major version 'v1' and will be kept stable.

hawkBit (Spring boot) starters

Next to the Example Application we are also providing a set of Spring Boot Starters to quick start your own Spring Boot based application.

Clone and build hawkBit

$ git clone https://github.com/eclipse/hawkbit.git
$ cd hawkbit
$ mvn clean install

Start hawkBit Update Server

Update Server

$ java -jar ./hawkbit-runtime/hawkbit-update-server/target/hawkbit-update-server-#version#.jar

Start hawkBit device simulator

Device Simulator

$ java -jar ./examples/hawkbit-device-simulator/target/hawkbit-device-simulator-#version#.jar

Generate Getting Started data

Example Management API Client

$ java -jar ./examples/hawkbit-example-mgmt-simulator/target/hawkbit-example-mgmt-simulator-#version#.jar

Releases and Roadmap

• In the upcoming release 0.2:
  • Rollout management for large scale update campaigns.
  • Clustering capabilities for the update server.
  • Upgrade of Spring Boot and Vaadin dependencies (Boot 1.4, Vaadin 7.7).
  • Improvements on modularization and customizability based on Spring's auto-configuration mechanism.
  • Provide Spring Boot Starters for custom apps based on hawkBit.
  • Provide standard runtime by means of Spring Boot based hawkBit update server (and hopefully a docker image).
  • And of course tons of usability improvements and bug fixes.
• Future releases
  • Complete repository refactoring.
  • Integrate with Eclipse hono as DMF provider.
  • Flexible DMF messaging infrastructure (e.g. with Spring Cloud Stream).
  • Migrate to Spring Framework 5, Spring Boot 2 and Vaadin 8
  • Re-evaluate JPA as persistence provider (e.g. look into jOOQ)