/hassio-os

:beginner: Hass.io OS docker hypervisor

Primary LanguageMakefileApache License 2.0Apache-2.0

HassOS

Hass.io OS based on buildroot. It's a hypervisor for Docker and supports various kind of IoT hardware. It is also available as virtual appliance. The whole system is optimized for embedded system and security. You can update the system simple with OTA updates or offline updates.

Focus

  • Linux kernel 4.15
  • Barebox as bootloader
  • RAUC for OTA updates
  • SquashFS LZ4 as filesystem
  • Docker 17.12.1
  • AppArmor protected
  • ZRAM LZ4 for /tmp, /var, swap
  • Run every supervisor

Schemas

Configuration

Create a USB stick with a partition named "hassos-config". This partition can include follow files:

  • network-* (NetworkManager keyfiles)
  • known_hosts (SSH)
  • hassos*.ota (Firmware updates)

Customize

Provide a file with the name hassos.json in your data partition and the following structure:

{
  "supervisor": "repo/image",
  "supervisor_args": "optional / custom docker arguments",
  "cli": "repo/image",
  "cli_args": "optional / custom docker arguments",
  "hostname": "default hostname"
}

Building

Running sudo ./enter.sh will get you into the build Docker container.
make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external xy_defconfig

Helpers

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external xy_defconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external menuconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external linux-menuconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external barebox-menuconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external busybox-menuconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external savedefconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external linux-update-defconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external barebox-update-defconfig

  • make -C /build/buildroot BR2_EXTERNAL=/build/buildroot-external busybox-update-config