updatehub/updatehub-ce repository overview

UpdateHub is an enterprise-grade solution which makes simple to remotely update all your Linux-based devices in the field. It handles all aspects related to sending Firmware Over-the-Air (FOTA) updates with maximum security and efficiency, while you focus in adding value to your product.

To learn more about UpdateHub, check out our documentation⁠.

⁠Features

• Yocto Linux support: Integrate UpdateHub onto your existing Yocto based project
• Scalable: Send updates to one device, or one million
• Reliability and robustness: Automated rollback in case of update fail
• Powerful API & SDK: Extend UpdateHub to fit your needs

⁠UpdateHub Community Edition

This is a community edition of UpdateHub Cloud, so the core concepts and functionality is identical.

See the comparison table below to help you to choose which version fits you need:

⁠Usage

$ docker run updatehub/updatehub-ce --help
Usage:
  updatehub-ce [flags]

Flags:
      --db string         Database file (default "updatehub.db")
  -h, --help              help for updatehub-ce
      --password string   Admin password (default "admin")
      --port int          Port (default 8080)
      --username string   Admin username (default "admin")

Example:
docker run -d -p 8080:8080 updatehub/updatehub-ce:latest

⁠Building

The updatehub-ce uses go mod to manage its dependencies and yarn to build the web UI for the server. go mod should be included in your default instalation of the go toolchain.

You can refer to yarn's documentation page for informations on how to install it in yor system: https://classic.yarnpkg.com/en/docs/install/⁠

After that, need to install packr that is a simple solution for bundling static assets inside of Go binaries use by updatehub-ce.

To install Packr utility and the dependencies:

$ go get -u github.com/gobuffalo/packr/packr
$ go get -u github.com/gobuffalo/packr

Finally, you can build updatehub-ce as:

$ cd <YOUR-UPDATEHUB-CE-PATH>/ui/ && yarn install && yarn run build && cd ..
$ packr install
$ go build
$ go install

Now you can run the updatehub-ce as:

./updatehub-ce --http 8080

⁠Contributing

UpdateHub is an open source project and we love to receive contributions from our community. If you would like to contribute, please read our contributing guide⁠.

⁠License

UpdateHub Community Edition is licensed under the MIT license. See LICENSE⁠ for the full license text.

⁠Getting in touch

• Reach us on Gitter⁠
• All source code are in Github⁠
• Email us at [email protected]⁠