The Wayback Machine - https://web.archive.org/web/20220614033722/https://github.com/home-assistant/operating-system
Skip to content

home-assistant/operating-system

dev
Switch branches/tags
9 branches 108 tags
Code

Latest commit

@agners
agners Increase maximum socket receive and send buffer size (#1964) (#1968)
720f604 Jun 8, 2022
Increase maximum socket receive and send buffer size (#1964) (#1968) 
Some applications try to increase the buffers for performance reason. The
QUIC Go implementation for instance tries to request a 2048 kiB buffer
size.

The kernel default depends on skubuf size (which is architecture
dependent), but it is memory size independet and typically around 200 kiB
(see [1]).

Other network tuning guides suggest 16MiB for 1GB ethernet, as well as
changing the default as well as maximum bufffer size (see [2]). This
conservatively increases the maximum buffer size to 4MiB.

[1]: https://elixir.bootlin.com/linux/v5.15.45/source/include/net/sock.h#L2742
[2]: https://nateware.com/2013/04/06/linux-network-tuning-for-2013/
720f604

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
.github
 
 
Documentation
 
 
buildroot @ 7995541
 
 
buildroot-external
 
 
scripts
 
 
.dockerignore
 
 
.gitignore
 
 
.gitmodules
 
 
.hadolint.yaml
 
 
Dockerfile
 
 
LICENSE
 
 
Makefile
 
 
README.md
 
 
Home Assistant Operating System Features Supported hardware Getting Started Development Components Development builds

README.md

Home Assistant Operating System

Home Assistant Operating System (formerly HassOS) is a Linux based operating system optimized to host Home Assistant and its Add-ons.

Home Assistant Operating System uses Docker as Container engine. It by default deploys the Home Assistant Supervisor as a container. Home Assistant Supervisor in turn uses the Docker container engine to control Home Assistant Core and Add-Ons in separate containers. Home Assistant Operating System is not based on a regular Linux distribution like Ubuntu. It is built using Buildroot and it is optimized to run Home Assistant. It targets single board compute (SBC) devices like the Raspberry Pi or ODROID but also supports x86-64 systems with UEFI.

Features

  • Lightweight and memory-efficient
  • Minimized I/O
  • Over The Air (OTA) updates
  • Offline updates
  • Modular using Docker container engine

Supported hardware

  • Raspberry Pi
  • Hardkernel ODROID
  • Asus Tinker Board
  • Generic x86-64 (e.g. Intel NUC)
  • Virtual appliances

See the full list and specific models here

Getting Started

If you just want to use Home Assistant the official getting started guide and installation instructions take you through how to download Home Assistant Operating System and get it running on your machine.

If you're interested in finding out more about Home Assistant Operating System and how it works read on...

Development

If you don't have experience with embedded systems, Buildroot or the build process for Linux distributions it is recommended to read up on these topics first (e.g. Bootlin has excellent resources).

The Home Assistant Operating System documentation can be found on the Home Assistant Developer Docs website.

Components

  • Bootloader:
    • Barebox for devices that support UEFI
    • U-Boot for devices that don't support UEFI
  • Operating System:
  • File Systems:
    • SquashFS for read-only file systems (using LZ4 compression)
    • ZRAM for /tmp, /var and swap (using LZ4 compression)
  • Container Platform:
    • Docker Engine for running Home Assistant components in containers
  • Updates:
    • RAUC for Over The Air (OTA) and USB updates
  • Security:

Development builds

The Development build GitHub Action Workflow is a manually triggered workflow which creates Home Assistant OS development builds. The development builds are available at os-builds.home-assistant.io.

About

🔰 Home Assistant Operating System

Topics

docker iot hass home-assistant buildroot hacktoberfest nb hassio-os vvc

Resources

Readme

License

Apache-2.0 license

Code of conduct

Code of conduct

Stars

2.4k stars

Watchers

114 watching

Forks

652 forks

Releases 108

Home Assistant OS 8.2 Latest
Jun 8, 2022
+ 107 releases

Packages

No packages published

Contributors 92

+ 81 contributors

Languages