mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Clarify supported systems for Supervised, improve installation instructions (#12412)
* Clarify supported systems for Supervised, improve installation instructions * Update source/hassio/installation.markdown Co-Authored-By: Pascal Vizeli <pvizeli@syshack.ch> Co-authored-by: Pascal Vizeli <pvizeli@syshack.ch>
This commit is contained in:
parent
72d0173a71
commit
b30feb926f
@ -106,82 +106,59 @@ You can also install Home Assistant on a Linux operating system of choice, calle
|
|||||||
|
|
||||||
Home Assistant Supervised, will still give you access to most features Home Assistant has to offer, including add-ons.
|
Home Assistant Supervised, will still give you access to most features Home Assistant has to offer, including add-ons.
|
||||||
|
|
||||||
The packages you need to have available on your system needed to Home Assistant may vary.
|
### Supported systems and limitations
|
||||||
|
|
||||||
### Debian/Ubuntu
|
While Home Assistant Supervised can be run on practically any Linux systems,
|
||||||
|
the Home Assistant project limits support for this installation method.
|
||||||
|
|
||||||
- `apparmor-utils`
|
Only the use of Debian or Ubuntu is supported. Other Linux-based system may work
|
||||||
- `apt-transport-https`
|
but is not part of our testing and thus not supported.
|
||||||
- `avahi-daemon`
|
|
||||||
- `ca-certificates`
|
|
||||||
- `curl`
|
|
||||||
- `dbus`
|
|
||||||
- `jq`
|
|
||||||
- `socat`
|
|
||||||
- `software-properties-common`
|
|
||||||
|
|
||||||
Optional:
|
Furthermore, if you choose to run Home Assistant Supervised, the operating
|
||||||
|
system of your choosing (including Debian/Ubuntu) is **your** responsibility.
|
||||||
|
Both in terms of systems upgrade and system configuration.
|
||||||
|
|
||||||
- `network-manager`
|
Customizations to your custom operating system may interfere with Home Assistant.
|
||||||
|
For that reason, please be sure you have to knowledge to manage, configure and
|
||||||
|
maintain the operating system of your choosing.
|
||||||
|
|
||||||
<div class='note warning'>
|
When in doubt, we highly recommend using the regular installation of Home
|
||||||
|
Assistant as provided above. In that case, Home Assistant will manage and update
|
||||||
Without the NetworkManager, you will be not able to control your host network setup over the UI. The `modemmanager` package will interfere with any Z-Wave or Zigbee stick and should be removed or disabled. Failure to do so will result in random failures of those integrations. For example, you can disable with `sudo systemctl disable ModemManager` and remove with `sudo apt-get purge modemmanager`
|
the Home Assistant Operating System for you.
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
### Arch Linux
|
|
||||||
|
|
||||||
- `apparmor`
|
|
||||||
- `avahi`
|
|
||||||
- `ca-certificates`
|
|
||||||
- `curl`
|
|
||||||
- `dbus`
|
|
||||||
- `docker`
|
|
||||||
- `jq`
|
|
||||||
- `socat`
|
|
||||||
|
|
||||||
You also need to have Docker-CE installed. There are well-documented procedures for installing Docker on Ubuntu at [Docker.com](https://docs.docker.com/install/linux/docker-ce/ubuntu/), you can find installation steps for your Linux distribution in the menu on the left.
|
|
||||||
|
|
||||||
<div class='note warning'>
|
|
||||||
|
|
||||||
Some distributions, like Ubuntu, have a `docker.io` package available. Using that package will cause issues!
|
|
||||||
Be sure to install the official Docker-CE from the above-listed URL.
|
|
||||||
|
|
||||||
Docker is not always ready with a release when a new Ubuntu version is out. Check if your version of Ubuntu is supported by Docker [here](https://docs.docker.com/install/linux/docker-ce/ubuntu/).
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
### Preparation
|
### Preparation
|
||||||
|
|
||||||
To prepare your machine for the Home Assistant installation, run the following commands:
|
To prepare your machine for the Home Assistant installation, run the following commands:
|
||||||
|
|
||||||
For Ubuntu:
|
If you run Ubuntu, first run this command:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
add-apt-repository universe
|
sudo add-apt-repository universe
|
||||||
```
|
```
|
||||||
|
|
||||||
Debian/Ubuntu:
|
Next run the following commands (for both Debian and Ubuntu):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo -i
|
sudo -i
|
||||||
apt-get update
|
apt-get update
|
||||||
apt-get install -y software-properties-common apparmor-utils apt-transport-https avahi-daemon ca-certificates curl dbus jq network-manager socat
|
apt-get install -y software-properties-common apparmor-utils apt-transport-https avahi-daemon ca-certificates curl dbus jq network-manager socat
|
||||||
systemctl disable ModemManager
|
systemctl disable ModemManager
|
||||||
|
systemctl stop ModemManager
|
||||||
curl -fsSL get.docker.com | sh
|
curl -fsSL get.docker.com | sh
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Installation of Home Assistant Supervised
|
||||||
|
|
||||||
The following script will then install Home Assistant on a variety of operating systems and machine types.
|
The following script will then install Home Assistant on a variety of operating systems and machine types.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
curl -sL "https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh" | bash -s
|
curl -sL "https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh" | bash -s
|
||||||
```
|
```
|
||||||
|
|
||||||
Some installation types require flags to identify the computer type, for example, when using a Raspberry Pi 3, the flag `-- -m raspberrypi3` is required. The install script would then look like this:
|
Some installation types require flags to identify the computer type, for example, when using a Raspberry Pi 4, the flag `-- -m raspberrypi4` is required. The install script would then look like this:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
curl -sL "https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh" | bash -s -- -m raspberrypi3
|
curl -sL "https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh" | bash -s -- -m raspberrypi4
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Other machine types
|
#### Other machine types
|
||||||
@ -194,7 +171,7 @@ curl -sL "https://raw.githubusercontent.com/home-assistant/hassio-installer/mast
|
|||||||
- `raspberrypi4`
|
- `raspberrypi4`
|
||||||
- `raspberrypi4-64`
|
- `raspberrypi4-64`
|
||||||
- `odroid-c2`
|
- `odroid-c2`
|
||||||
- `odroid-cu2`
|
- `odroid-n2`
|
||||||
- `odroid-xu`
|
- `odroid-xu`
|
||||||
- `tinker`
|
- `tinker`
|
||||||
- `qemuarm`
|
- `qemuarm`
|
||||||
@ -206,12 +183,6 @@ See the [hassio-installer](https://github.com/home-assistant/hassio-installer) G
|
|||||||
|
|
||||||
If you can not find your machine type in the list, you should pick the `qemu` release. i.e., `qemux86-64` for a normal 64-bit Linux distribution, or `qemuarm-64` for most modern ARM-based target like Raspberry Pi clones, or TV boxes.
|
If you can not find your machine type in the list, you should pick the `qemu` release. i.e., `qemux86-64` for a normal 64-bit Linux distribution, or `qemuarm-64` for most modern ARM-based target like Raspberry Pi clones, or TV boxes.
|
||||||
|
|
||||||
<div class='note'>
|
|
||||||
When you use this installation method, the core SSH add-on may not function correctly. If that happens, use the community SSH add-on. Some of the documentation might not work for your installation either.
|
|
||||||
</div>
|
|
||||||
|
|
||||||
A detailed guide about running Home Assistant as a virtual machine is available in the [blog][hassio-vm].
|
|
||||||
|
|
||||||
[balenaEtcher]: https://www.balena.io/etcher
|
[balenaEtcher]: https://www.balena.io/etcher
|
||||||
[Virtual Appliance]: https://github.com/home-assistant/operating-system/blob/dev/Documentation/boards/ova.md
|
[Virtual Appliance]: https://github.com/home-assistant/operating-system/blob/dev/Documentation/boards/ova.md
|
||||||
[hassos-network]: https://github.com/home-assistant/operating-system/blob/dev/Documentation/network.md
|
[hassos-network]: https://github.com/home-assistant/operating-system/blob/dev/Documentation/network.md
|
||||||
@ -235,5 +206,4 @@ A detailed guide about running Home Assistant as a virtual machine is available
|
|||||||
[samba]: /addons/samba/
|
[samba]: /addons/samba/
|
||||||
[ssh]: /addons/ssh/
|
[ssh]: /addons/ssh/
|
||||||
[pi-power]: https://www.raspberrypi.org/help/faqs/#powerReqs
|
[pi-power]: https://www.raspberrypi.org/help/faqs/#powerReqs
|
||||||
[hassio-vm]: /blog/2017/11/29/hassio-virtual-machine/
|
|
||||||
[configure]: /getting-started/configuration/
|
[configure]: /getting-started/configuration/
|
||||||
|
Loading…
x
Reference in New Issue
Block a user