Skip to content

buanet/ioBroker.raspberry-os

Repository files navigation

Official Raspberry OS image for ioBroker

Release Github Issues
License Donate

This project is used to auto generate pre configured Raspberry OS images for ioBroker IoT platform. For more details about ioBroker see: iobroker.net.

🚀 Quick links

Don't know what's ioBroker? ➡️ iobroker.net
Don't know what's a Raspberry Pi? ➡️ raspberrypi.org
Looking for the image to download? ➡️ see latest release

This build uses the official Raspberry Pi OS build script from https://github.com/RPi-Distro/pi-gen. It takes the stages for the default lite image and adds a custom stage for setting up ioBroker.

Build your own Raspberry OS image

Of course you can use this code to locally build your ioBroker RaspberryPi OS image from scratch. This is how it works.

Prerequisites

This script is made for running on a Linux Platform like Debian or Ubuntu. As this build script is using Docker, make sure you have it up and running on your machine.

Clone the code to your local system:

git clone https://github.com/buanet/ioBroker.raspberry-os

Starting build

Start the build process (from inside the cloned ioBroker.raspberry-os folder):

sudo ./build-iobrokerpi.sh

The script will download pi-gen source and start building automatically.

Depending on your environment, the process can take some (more) time.

After success you will find your Image in ./pi-gen/deploy/.

Cleanup

Cleanup your workspace with the included cleanup script. It will delete the pi-gen source and the used docker container.

sudo ./cleanup.sh

Configuration

You can configure settings like locales, default User and more by editing the config file. For more details see the original pi-gen readme.md.

Changelog

v1.3.0 (2022-02-20)

  • add rpi-imager support
  • add new ci

v1.2.0 (2021-08-08)

  • add uuid reset procedure for iobroker
  • update default config_de

v1.1.0 (2021-07-27)

  • add automated build process with github actions
  • default user is now "pi"

v1.0.0 (2021-03-08)

  • add some documentation
  • v0.0.2 (2021-02-01)
    • change memory split
    • change boot target
  • v0.0.1 (2021-01-27)
    • project started / initial release

License

MIT License

Copyright (c) 2022 André Germann

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Credits

This project uses the official RPi-Distro/pi-gen and is inspired by the Honey-Pi project.