mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 21:36:52 +00:00
Release HassOS (#5747)
* Release HassOS * Update 2018-07-11-hassio-images.markdown * Update 2018-07-11-hassio-images.markdown * Update 2018-07-11-hassio-images.markdown * Update index.markdown * Update index.markdown * Update index.markdown * Update installation.markdown * Update 2018-07-11-hassio-images.markdown * ✏️ Initial review. * ✏️ Blog post tweaks * ✏️ Getting started index tweaks * ✏️ Tweaks to Hassio index * ✏️ Tweaks to Hassio installation guide * ✏️ Processes review feedback * ✏️ Updates title & description. * ✏️ Processed review * Redundant information * Update 2018-07-11-hassio-images.markdown * Update 2018-07-11-hassio-images.markdown * Add files via upload * Delete blogpost.png * Create TEST.TXT * Add files via upload * Delete TEST.TXT
This commit is contained in:
Pascal Vizeli
GitHub
parent
e748ea0492
commit
b0a1e16dfc
64
source/_posts/2018-07-11-hassio-images.markdown
Normal file
64
source/_posts/2018-07-11-hassio-images.markdown
Normal file
@ -0,0 +1,64 @@
|
||||
---
|
||||
layout: post
|
||||
title: "New Hass.io images, based on HassOS"
|
||||
description: "We have released HassOS, a brand new operating system for the purpose of running Hass.io"
|
||||
date: 2018-07-11 00:00:00
|
||||
date_formatted: "April 22, 2018"
|
||||
author: Pascal Vizeli
|
||||
author_twitter: pvizeli
|
||||
comments: true
|
||||
categories: Announcements
|
||||
og_image: /images/blog/2018-07-hassio-images/blogpost.png
|
||||
---
|
||||
|
||||
After 4 months of hard work, we are happy to announce our new images for Hass.io, based on HassOS. HassOS is a brand new operating system that we have created specifically for the purpose of running Hass.io. And yes, this supports the Raspberry Pi 3 B+!
|
||||
|
||||
## {% linkable_title What is new %}
|
||||
|
||||
We have built HassOS on top of the [Buildroot] framework. The focus of the system is to be a very small and highly efficient operating system to run Docker like a hypervisor. It has just enough software installed, to run a supervisor. We have also focused on security, there are, for example, no default passwords and we use [AppArmor] to protect the applications and containers on HassOS.
|
||||
|
||||
Key features:
|
||||
|
||||
- Safe and secure updating with [Rauc] over USB or internet (OTA)
|
||||
- Uses an LZ4 compressed root filesystem and parts of the memory
|
||||
- Read-only root filesystem, designed to run on embedded systems
|
||||
- Dbus connected hosts services
|
||||
- Latest LT Linux kernel
|
||||
- Latest Docker-ce version
|
||||
- Fully supported NetworkManager
|
||||
- Bluetooth support using Bluez
|
||||
- Supports lot different hardware
|
||||
|
||||
## {% linkable_title Migration %}
|
||||
|
||||
The design of HassOS is different from ResinOS. Because of this, we can't provide an OTA update from the old ResinOS system to the new HassOS based system.
|
||||
|
||||
You need to perform the following steps to upgrade:
|
||||
|
||||
1. If you have installed the Bluetooth add-on, please remove it, since it is no longer required.
|
||||
2. Make a Hass.io snapshot of your current system and download it to your computer.
|
||||
3. Download the latest [Hass.io stable][installation] version.
|
||||
4. Flash the downloaded Hass.io image with [Etcher] to your SD card.
|
||||
5. Raspberry Pi: In case you have modified the `config.txt` (in the boot partition), you will also need to apply these changes to HassOS. Do **NOT** simply copy the file from your old setup into HassOS! Apply those changes manually!
|
||||
6. If you use a custom network configuration or have configured SSH development access, you need to create a configuration [USB stick]. Copy the resin-sample into the `network` folder on a USB stick and insert it into your device.
|
||||
7. Take the freshly flashed SD card with HassOS and place it into your device, and boot it by turning it on.
|
||||
8. Copy the snapshot into the host with the SSH or Samba add-on.
|
||||
9. Restore your snapshot via the Hass.io panel.
|
||||
10. Done!
|
||||
|
||||
## {% linkable_title Future %}
|
||||
|
||||
HassOS is a wonderful base system and allows us to start working on integrating all kinds of amazing features into Hass.io (and bring them to the UI as well). For example, we are planning on bringing network and Bluetooth configuration possibilities into the UI. The goal is a full featured hub system that allows anybody to use Home Assistant.
|
||||
|
||||
The Hass.io API is extensive, and we are going to adopt more of its features into Home Assistant as well. For example, sensors that allows you to monitor the system usage of an add-on or even Home Assistant itself.
|
||||
|
||||
A big shout out to all people who donated money for us to buy hardware! Thank you! We have already started on making HassOS compatible with all kinds of hardware and are currently aiming to release support for new devices every 7-14 days and keeping this up until we support all major IoT boards.
|
||||
|
||||
Feel free to jump into the project and help us to improve the documentation or other tasks that are going to help us moving forward.
|
||||
|
||||
[Rauc]: Safe and Secure Updating
|
||||
[Buildroot]: https://buildroot.org/
|
||||
[AppArmor]: https://gitlab.com/apparmor/apparmor/wikis/home/
|
||||
[USB stick]: https://github.com/home-assistant/hassos/blob/rel-1/Documentation/configuration.md#automatic
|
||||
[installation]: https://www.home-assistant.io/hassio/installation/
|
||||
[Etcher]: https://etcher.io/
|
||||
@ -11,7 +11,7 @@ footer: true
|
||||
|
||||
The goal of this getting started guide is to install [Hass.io](/hassio/) on a Raspberry Pi 3. Hass.io is our own all in one solution that turns your Raspberry Pi into the ultimate home automation hub.
|
||||
|
||||
Follow this guide if you want to easily get started with Home Assistant, or if you have no or little Linux experience. For advanced users or if you have no Raspberry Pi at hand, check our [alternative installation methods](/docs/installation/). The [FAQ](/faq/#home-assistant-vs-hassio) explains more about the differences.
|
||||
Follow this guide if you want to get started with Home Assistant easily, or if you have no or little Linux experience. For advanced users or if you have no Raspberry Pi at hand, check our [alternative installation methods](/docs/installation/). The [FAQ](/faq/#home-assistant-vs-hassio) explains more about the differences.
|
||||
|
||||
<p class='note warning'>
|
||||
Please remember to [secure your installation](/docs/configuration/securing/) once you've finished with the installation process.
|
||||
@ -24,38 +24,35 @@ We will need a few things to get started with installing Home Assistant. Links b
|
||||
- [Raspberry Pi 3 model B](http://a.co/gEfMqL4) + [Power Supply](https://www.raspberrypi.org/help/faqs/#powerReqs) (at least 2.5A)
|
||||
- [Micro SD Card](http://a.co/gslOydD). Get one that is Class 10 as they are more reliable. Size 32 GB or bigger recommended.
|
||||
- SD Card reader. Part of most laptops, and also available as [standalone USB sticks](http://a.co/5FCyb0N) (the brand doesn't matter, just pick the cheapest)
|
||||
- Ethernet cable (optional, Hass.io can work with WiFi too)
|
||||
|
||||
<p class='note'>
|
||||
Support for the Raspberry Pi 3 model B+ is available in the alternative installation method [Hassbian](/docs/hassbian/installation/).
|
||||
|
||||
The recently released Raspberry Pi 3 model B+ is not yet supported by Hass.io.
|
||||
</p>
|
||||
- Ethernet cable (optional, Hass.io can work with WiFi as well)
|
||||
- A USB-Stick (optional, allows for unattended configuration)
|
||||
|
||||
### {% linkable_title Software requirements %}
|
||||
|
||||
- Download [Hass.io image for Raspberry Pi 3][pi3]
|
||||
- Download Hass.io image for Raspberry Pi 3 as [32bit][pi3-32] or [64bit][pi3-64] variant
|
||||
- Download [Etcher] to write the image to an SD card
|
||||
- Text Editor like [Visual Studio Code](https://code.visualstudio.com/)
|
||||
|
||||
[Etcher]: https://etcher.io/
|
||||
[pi3]: https://github.com/home-assistant/hassio-build/releases/download/1.3/resinos-hassio-1.3-raspberrypi3.img.bz2
|
||||
[pi3-32]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_rpi3-1.5.img.gz
|
||||
[pi3-64]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_rpi3-64-1.5.img.gz
|
||||
|
||||
### {% linkable_title Installing Hass.io %}
|
||||
|
||||
1. Put the SD card in your SD card reader.
|
||||
1. Open Etcher, select the Hass.io image and flash it to the SD card.
|
||||
1. WiFi setup only: open the file `system-connections/resin-sample` (from the `resin-boot` volume on the SD card) with a text editor. Change `ssid` to be your network name and `psk` to be your password. Note: When connecting to a 5 GHz-only network, make sure your device supports that. If you don't know what that means, then you probably have nothing to worry about.
|
||||
1. WiFi setup only: Format a USB-Stick with name `CONFIG` and copy one of [the examples] to the file `network/hassos-wifi`.
|
||||
1. Unmount the SD card and remove it from your SD card reader.
|
||||
1. Insert the SD card into your Raspberry Pi 3. If you are going to use an Ethernet cable, connect that too.
|
||||
1. Connect your Raspberry Pi to the power supply so it turns on.
|
||||
1. The Raspberry Pi will now boot up, connect to the Internet and download the latest version of Home Assistant. This will take about 20 minutes. Do not expect anything but the Home Assistant logo on the HDMI display, or any use for a keyboard or mouse.
|
||||
1. Connect your Raspberry Pi to the power supply, so it turns on.
|
||||
1. The Raspberry Pi will now boot up, connect to the Internet and download the latest version of Home Assistant, which will take about 20 minutes.
|
||||
1. Home Assistant will be available at [http://hassio.local:8123][local]. Shortly after the download has started, a simple preparation status page will be available at this URL. Point your browser there. The page refreshes automatically, and Home Assistant will be shown when the download is complete.
|
||||
|
||||
[local]: http://hassio.local:8123
|
||||
[the examples]: https://github.com/home-assistant/hassos/blob/dev/Documentation/network.md
|
||||
|
||||
<p class='note'>
|
||||
When you're done, remember to set up regular backups of your configuration. This will protect you from hardware failure and mistakes. On Hass.io you have snapshots, but you can back up to [GitHub](/docs/ecosystem/backup/backup_github/), [DropBox](/docs/ecosystem/backup/backup_dropbox/) and many other ways. All that matters is that you set them up and test them regularly.
|
||||
When you're done, remember to set up regular backups of your configuration. These backups will protect you from hardware failure and mistakes. On Hass.io you have snapshots, but you can back up to [GitHub](/docs/ecosystem/backup/backup_github/), [DropBox](/docs/ecosystem/backup/backup_dropbox/) and many other ways. All that matters is that you set them up and test them regularly.
|
||||
</p>
|
||||
|
||||
### [Next step: Configuring Home Assistant »](/getting-started/configuration/)
|
||||
|
||||
@ -19,10 +19,10 @@ The advantages of using Hass.io:
|
||||
- Free and open source
|
||||
- Optimized for embedded devices like Raspberry Pi
|
||||
- 100% local home automation
|
||||
- Easy installation and updates (powered by [ResinOS] and [Docker])
|
||||
- Management user interface integrated into Home Assistant
|
||||
- Easily create and restore full backups of your whole configuration.
|
||||
- Easily install many popular add-ons including [Google Assistant], encryption via [Let's Encrypt] and dynamic DNS via [Duck DNS].<br><br>[Browse available add-ons »][all]<br><br>
|
||||
- Easy installation and updates (powered by [HassOS] and [Docker])
|
||||
- Management web interface integrated into Home Assistant
|
||||
- Create and restore full backups of your whole configuration with ease
|
||||
- Install many popular add-ons with a single click! For example [Google Assistant], encryption via [Let's Encrypt] and dynamic DNS via [Duck DNS].<br><br>[Browse available add-ons »][all]<br><br>
|
||||
- Active community that is helpful and sharing add-ons including AppDaemon, Homebridge and InfluxDB.<br><br>[Browse the forums »][forums]<br>[Join the Hass.io chat »][chat]<br>[Browse community add-on repositories »][comm-add-ons]<br><br>
|
||||
|
||||
<div class='videoWrapper'>
|
||||
@ -31,7 +31,7 @@ The advantages of using Hass.io:
|
||||
|
||||
### {% linkable_title Upgrading %}
|
||||
|
||||
Hass.io users can update Home Assistant via the 'Hass.io' page in the UI. However please note that Home Assistant updates take time to roll into the Hass.io builds. Therefore there is often a slight delay between the availability of a Home Assistant update and an update being available in Hass.io, be patient. When a Hass.io update is available, it will be shown as available on the ‘Hass.io' page in your UI.
|
||||
Hass.io users can update Home Assistant via the 'Hass.io' page in the UI. However, please note that a Home Assistant updates take time to roll into the Hass.io builds. Therefore there is often a slight delay between the availability of a Home Assistant update and the update being available in Hass.io, so be patient. When a Hass.io update is available, it will be shown as a notification in the ‘Hass.io' page in the web interface.
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/hassio/screenshots/dashboard.png'>
|
||||
@ -51,13 +51,13 @@ Hass.io upgrade process from the SSH command line
|
||||
[comm-add-ons]: https://community.home-assistant.io/tags/hassio-repository
|
||||
[all]: /addons/
|
||||
[chat]: https://discord.gg/K3UVxJd
|
||||
[ResinOS]: https://resinos.io/
|
||||
[HassOS]: https://github.com/home-assistant/hassos
|
||||
[Docker]: https://www.docker.com/
|
||||
[install]: /hassio/installation/
|
||||
|
||||
## {% linkable_title hassio command %}
|
||||
|
||||
On the SSH command line you can use the `hassio` command to retrieve logs, check the details of connected hardware, and more.
|
||||
On the SSH command line, you can use the `hassio` command to retrieve logs, check the details of connected hardware, and more.
|
||||
|
||||
Home Assistant:
|
||||
|
||||
@ -92,7 +92,7 @@ You can get a better description of the CLI capabilities by typing `hassio help`
|
||||
|
||||
```bash
|
||||
NAME:
|
||||
hassio - Commandline tool to allow interation with hass.io
|
||||
hassio - Commandline tool to allow interaction with hass.io
|
||||
|
||||
USAGE:
|
||||
hassio [global options] command [command options] [arguments...]
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
---
|
||||
layout: page
|
||||
title: "Installing Hass.io"
|
||||
description: "Instructions on how-to install Hass.io."
|
||||
description: "Instructions on how to install Hass.io."
|
||||
date: 2017-04-30 13:28
|
||||
sidebar: true
|
||||
comments: false
|
||||
@ -9,34 +9,24 @@ sharing: true
|
||||
footer: true
|
||||
---
|
||||
|
||||
Hass.io images are available for all available Raspberry Pi and Intel NUC platforms.
|
||||
Hass.io images are available for:
|
||||
|
||||
<p class='note warning'>
|
||||
The recently released Raspberry Pi 3 model B+ is not yet supported.
|
||||
</p>
|
||||
|
||||
- Download the appropriate image for your Raspberry Pi / Intel NUC:
|
||||
- Download the appropriate image for your IoT:
|
||||
- [Raspberry Pi / Zero][pi1]
|
||||
- [Raspberry Pi / Zero][pi0-w]
|
||||
- [Raspberry Pi 2][pi2]
|
||||
- [Raspberry Pi 3][pi3]
|
||||
- [Intel NUC][nuc]
|
||||
- [Raspberry Pi 3 32bit][pi3-32]
|
||||
- [Raspberry Pi 3 63bit][pi3-64]
|
||||
- As [Virtual Appliance]:
|
||||
- [VMDK][vmdk]
|
||||
|
||||
<p class='note'>
|
||||
Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) with your Pi. Mobile chargers may not be suitable since some are designed to only provide the full power with that manufacturer's handsets.
|
||||
Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) with your Pi. Mobile chargers may not be suitable since some were only designed to provide just enough power to the device it was designed for by the manufacturer.
|
||||
</p>
|
||||
|
||||
- Flash the downloaded image to an SD card using [Etcher].
|
||||
|
||||
<p class='note warning'>
|
||||
There is an [issue in the Etcher flashing process on Mac OS High Sierra](https://github.com/resin-io/etcher/issues/1908).
|
||||
There is an easy workaround, just uncompress the image first.
|
||||
|
||||
```bash
|
||||
$ bunzip2 -c resinos-hassio-1.3-raspberrypi3.img.bz2 > image.img
|
||||
```
|
||||
</p>
|
||||
|
||||
- Optional - Setup the WiFi or static IP: On the SD-card, edit the `system-connections/resin-sample` file and follow the [ResinOS howto][resinos-network].
|
||||
- Optional - Setup the WiFi or static IP: On the SD-card, create the `network/my-network` file and follow the [HassOS howto][hassos-network].
|
||||
- Insert SD card to Raspberry Pi and turn it on. On first boot, it downloads the latest version of Home Assistant which takes ~20 minutes (slower/faster depending on the platform).
|
||||
|
||||
<img src='/images/hassio/screenshots/first-start.png' style='clear: right; border:none; box-shadow: none; float: right; margin-bottom: 12px;' width='150' />
|
||||
@ -45,7 +35,7 @@ Please remember to ensure you're using an [appropriate power supply](https://www
|
||||
- Enable either the [Samba add-on][samba] or the [SSH add-on][ssh] to manage your configuration in `/config/` (From the UI choose **Hass.io** which is located in the sidebar).
|
||||
|
||||
<p class='note'>
|
||||
If your router doesn't support mDNS then you'll have to use the IP address of your Pi, instead of `hassio.local`, for example `http://192.168.0.9:8123`. You should be able to find the IP address of your Pi from the admin interface of your router.
|
||||
If your router doesn't support mDNS, then you'll have to use the IP address of your Pi instead of `hassio.local`. For example, `http://192.168.0.9:8123`. You should be able to find the IP address of your Pi from the admin interface of your router.
|
||||
</p>
|
||||
|
||||
<p class='note'>
|
||||
@ -82,11 +72,14 @@ When you use this installation method, the core SSH add-on may not function corr
|
||||
A detailed guide about running Hass.io as a virtual machine is available in the [blog](/blog/2017/11/29/hassio-virtual-machine/).
|
||||
|
||||
[Etcher]: https://etcher.io/
|
||||
[resinos-network]: https://docs.resin.io/deployment/network/2.0.0/
|
||||
[pi1]: https://github.com/home-assistant/hassio-build/releases/download/1.3/resinos-hassio-1.3-raspberrypi.img.bz2
|
||||
[pi2]: https://github.com/home-assistant/hassio-build/releases/download/1.3/resinos-hassio-1.3-raspberrypi2.img.bz2
|
||||
[pi3]: https://github.com/home-assistant/hassio-build/releases/download/1.3/resinos-hassio-1.3-raspberrypi3.img.bz2
|
||||
[nuc]: https://github.com/home-assistant/hassio-build/releases/download/1.3/resinos-hassio-1.3-intel-nuc.img.bz2
|
||||
[Virtual Appliance]: https://github.com/home-assistant/hassos/blob/dev/Documentation/boards/ova.md
|
||||
[hassos-network]: https://github.com/home-assistant/hassos/blob/dev/Documentation/network.md
|
||||
[pi0-w]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_rpi0-w-1.5.img.gz
|
||||
[pi1]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_rpi-1.5.img.gz
|
||||
[pi2]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_rpi2-1.5.img.gz
|
||||
[pi3-32]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_rpi3-1.5.img.gz
|
||||
[pi3-64]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_rpi3-1.5.img.gz
|
||||
[vmdk]: https://github.com/home-assistant/hassos/releases/download/1.5/hassos_ova-1.5.vmdk
|
||||
[linux]: https://github.com/home-assistant/hassio-build/tree/master/install#install-hassio
|
||||
[local]: http://hassio.local:8123
|
||||
[samba]: /addons/samba/
|
||||
|
||||
BIN
source/images/blog/2018-07-hassio-images/blogpost.png
Normal file
BIN
source/images/blog/2018-07-hassio-images/blogpost.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 41 KiB |
Loading…
x
Reference in New Issue
Block a user