diff --git a/sass/custom/_component_page.scss b/sass/custom/_component_page.scss index 1b337c6d226..72c606c2c9b 100644 --- a/sass/custom/_component_page.scss +++ b/sass/custom/_component_page.scss @@ -103,9 +103,9 @@ display: inline-block; background-color: #fefefe; margin: 4px; - border-radius: 2px; - box-shadow: 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 1px 5px 0 rgba(0, 0, 0, 0.12), - 0 3px 1px -2px rgba(0, 0, 0, 0.2); + border-radius: 8px; + border: 1px solid rgba(0, 0, 0, .12); + box-shadow: rgba(0,0,0,0.06) 0 0 10px; padding: 8px; text-align: center; text-decoration: none; diff --git a/sass/custom/_details.scss b/sass/custom/_details.scss index ae6b4ca754c..a6117b1246c 100644 --- a/sass/custom/_details.scss +++ b/sass/custom/_details.scss @@ -7,8 +7,9 @@ div.details-block { background-color: white; padding: 4px 16px; margin: 8px; - box-shadow: 0px 4px 20px rgba(0, 0, 0, 0.1); - border-radius: 16px; + border: 1px solid rgba(0, 0, 0, .12); + box-shadow: rgba(0,0,0,0.06) 0 0 10px; + border-radius: 8px; .details-block-title { font-weight: bold; diff --git a/sass/custom/_features.scss b/sass/custom/_features.scss index 9172a3fc473..f350f7245e3 100644 --- a/sass/custom/_features.scss +++ b/sass/custom/_features.scss @@ -30,12 +30,6 @@ .card-content { padding-left: 24px; - .button { - font-size: small; - font-weight: 600; - text-decoration: none; - } - p:last-of-type, ul { margin-bottom: 12px; diff --git a/sass/custom/_getting_started.scss b/sass/custom/_getting_started.scss index 9cab303af76..85a35ec3c51 100644 --- a/sass/custom/_getting_started.scss +++ b/sass/custom/_getting_started.scss @@ -1,150 +1,260 @@ #getting_started { - .intro { - padding-bottom: 16px; + .intro { + padding-bottom: 16px; + font-size: 24px; + } + + .installations { + .label { + background: #e8e6f0; + border-radius: 4px; + padding: 6px 8px !important; + margin-bottom: 16px; + text-transform: uppercase; + font-size: 16px; + font-weight: 500; + width: fit-content; + + &.easiest { + color: #04b154; + } + &.easy { + color: #02b0ff; + } + &.intermediate { + color: #eb873f; + } + &.hard { + color: #ff5454; + } + &.expert { + color: #ff02b8; + } } - .installations { + h2 { + margin: 0; + } - h2 { - font-size: 0; - margin: 0; + .installations-card { + text-decoration: none !important; + color: black !important; + margin-bottom: 32px; + + .material-card { + display: flex; + flex-direction: row; + justify-content: space-between; + margin: 8px 0; + + h3 { + margin: 0; + margin-bottom: 4px; } - .installations-card { - text-decoration: none !important; - color: black !important; + .content-container { + display: flex; + width: 100%; - .material-card { + .image { + margin-right: 16px; + + img { + width: 200px; + height: 200px; + aspect-ratio: 1 / 1; + max-height: 300px; + border-radius: 4px; + vertical-align: middle; + object-fit: cover; + border: 1px solid rgba(0, 0, 0, 0.12); + } + } + + .icon { + margin-right: 16px; + height: 200px; + width: 200px; + padding: 40px; + display: flex; + justify-content: center; + align-items: center; + border-radius: 4px; + background-color: #c4c4c4; + > * { + border-radius: 0; + border: 0; + box-shadow: none; + width: 100%; + height: auto; + } + } + + .content { + flex: 1; + padding: 8px 0; + p { + font-size: 0.8em; + margin: 0; + } + b { + font-size: 0.7em; + } + + .columns { + display: flex; + width: 100%; + margin-top: 8px; + gap: 8px; + + & > * { + flex-basis: min-content; + flex-grow: 1; + } + } + + ul { + font-size: 0.7em; + margin: 0; + + li { + margin-left: 17px; + margin-bottom: 0; + } + } + .buttons { + margin-top: 16px; + display: flex; + flex-direction: column; + align-items: flex-start; + + .button { display: flex; - flex-direction: row; - justify-content: space-between; - margin: 8px 0; + padding-right: 20px; + &:not(:first-child) { + margin-top: 12px; + } - .content-container { - display: flex; - - div:first-of-type { - margin-right: 24px; - - img, svg { - max-width: 170px; - max-height: 170px; - min-width: 170px; - min-height: 170px; - padding: 32px; - border-radius: 3px; - box-shadow: rgba(0,0,0,0.06) 0 0 10px; - vertical-align: middle; - border: 5px solid #fff; - } - } - - div:last-of-type { - - b { - font-size: 28px; - } - - p { - font-size: 0.8em; - margin: 0; - } - - ul { - font-size: 0.8em; - margin-left: 24px; - margin-top: 1rem; - - li { - margin: 0; - } - } - } + &.accent { + background-color: #34b155; } svg { - height: 42px; - max-width: 42px; - min-width: 42px; - align-self: center; + fill: white; + height: 24px; + min-width: 24px; } + } } + } } + } + } + } + + .compare-installations td, + .compare-installations th { + text-align: center; + } + + .compare-installations { + background-color: #ffffff !important; + border-radius: 8px; + border: 1px solid rgba(0, 0, 0, 0.12); + box-shadow: rgba(0, 0, 0, 0.06) 0 0 10px; + margin-bottom: 1.5rem; + + table { + margin-bottom: 0; } - .compare-installations td,.compare-installations th { - text-align: center; + td, + th { + text-align: center; } - - table.compare-installations { - background-color: #ffffff !important; - border-radius: 2px !important; - box-shadow: 0 2px 2px 0 rgba(0,0,0,0.14), - 0 1px 5px 0 rgba(0,0,0,0.12), - 0 3px 1px -2px rgba(0,0,0,0.2) !important; - td, th { - text-align: center; - } - - tr { - td:first-of-type { - text-align: left; - } - } - - tr:nth-child(even) { - background-color: #fafafa; - } + tr { + td:first-of-type { + text-align: left; + } } + + tr:nth-child(even) { + background-color: #fafafa; + } + } } .link-card { - text-decoration: none !important; - color: black !important; - div { - margin: 32px 0; - height: 64px; - display: flex; - justify-content: space-between; - svg { - height: 32px; - width: 32px; - max-width: 32px; - } - p { - margin: 0; - align-self: center; - } + text-decoration: none !important; + color: black !important; + div { + margin: 32px 0; + height: 64px; + display: flex; + justify-content: space-between; + svg { + height: 32px; + width: 32px; + max-width: 32px; } + p { + margin: 0; + align-self: center; + } + } } .next-step { - p { - text-transform: uppercase; - } + p { + text-transform: uppercase; + } } -@media only screen and (max-width: $palm-end) { - #getting_started { - .installations { - .installations-card { - .material-card { - .content-container { - flex-flow: wrap; - svg { - display: block; - } - div:first-of-type { - width: 100%; - display: flex; - justify-content: center; - margin-bottom: 16px; - } - } - svg { - display: none; - } - } +@media only screen and (max-width: 650px) { + #getting_started { + .installations { + .installations-card { + .material-card { + .content-container { + flex-direction: column; + .image { + width: 100%; + display: flex; + justify-content: center; + margin-right: 0; + margin-bottom: 16px; + + img { + width: 100%; + height: unset; + } } + .icon { + width: 100%; + height: 200px; + * { + height: 100%; + width: auto; + } + } + } } + } } -} \ No newline at end of file + } +} + +@media only screen and (max-width: 500px) { + #getting_started { + .installations { + .installations-card { + .material-card { + .content-container { + .columns { + flex-direction: column; + } + } + } + } + } + } +} diff --git a/sass/custom/_landingpage.scss b/sass/custom/_landingpage.scss index 27bf8a233e0..1d15ac7a700 100644 --- a/sass/custom/_landingpage.scss +++ b/sass/custom/_landingpage.scss @@ -46,7 +46,6 @@ $ha__primary_color: #03a9f4; svg { stroke: $ha__primary_color; } - } .wide { @@ -69,7 +68,6 @@ $ha__primary_color: #03a9f4; } } - .bottom { position: absolute; bottom: 8px; @@ -87,6 +85,8 @@ $ha__primary_color: #03a9f4; .button-row-with-icon { display: flex; justify-content: space-evenly; + flex-wrap: wrap; + gap: 16px; a { display: block; @@ -101,7 +101,7 @@ $ha__primary_color: #03a9f4; align-items: center; padding: 32px; text-align: center; - background: #FFFFFF; + background: #ffffff; width: 242px; height: 176px; box-shadow: 0px 4px 20px rgba(0, 0, 0, 0.1); @@ -131,13 +131,12 @@ $ha__primary_color: #03a9f4; } .section-content { - background-color: #FAFAFA; + background-color: #fafafa; width: 100%; display: grid; justify-items: center; padding: 64px; - .title { font-size: 24px; line-height: 28px; @@ -169,13 +168,16 @@ $ha__primary_color: #03a9f4; display: flex; flex-direction: row; width: 100%; - padding: 32px 128px; + padding: 32px; justify-content: space-evenly; .section-inner-content { align-self: center; padding: 0; + &.padding { + padding: 16px; + } div { width: 330px; @@ -184,12 +186,6 @@ $ha__primary_color: #03a9f4; .title { margin-bottom: 4px; } - - .button { - font-size: small; - font-weight: 600; - text-decoration: none; - } } img { @@ -208,7 +204,7 @@ $ha__primary_color: #03a9f4; } .section-content:nth-child(even) { - background-color: #F5F5F5; + background-color: #f5f5f5; .section-inner:nth-child(odd) { flex-direction: row-reverse; @@ -231,7 +227,6 @@ $ha__primary_color: #03a9f4; margin: -36px auto 0; &.with-box { - .banner-overlay-content { max-width: 416px; } @@ -353,7 +348,7 @@ $ha__primary_color: #03a9f4; .below-button { margin-top: 8px; text-align: center; - font-size: .8em; + font-size: 0.8em; } } @@ -719,7 +714,7 @@ $ha__primary_color: #03a9f4; .blue3d-container { align-items: flex-end; - background-image: url('/images/blue/blue_3d.jpg'); + background-image: url("/images/blue/blue_3d.jpg"); background-position: bottom; background-size: cover; display: flex; @@ -734,7 +729,7 @@ $ha__primary_color: #03a9f4; align-items: center; justify-content: space-between; background-color: #000000ab; - color: #FFFFFF; + color: #ffffff; height: 60px; width: 100%; @@ -748,7 +743,7 @@ $ha__primary_color: #03a9f4; } } - .material-card>p:last-child { + .material-card > p:last-child { margin-bottom: 0; } } @@ -911,13 +906,39 @@ $ha__primary_color: #03a9f4; } } +@media only screen and (max-width: $desk-start) { + #landingpage { + .section-content { + width: 100%; + padding: 32px 8px; + + .header { + width: 100%; + } + + .section-inner { + flex-direction: column-reverse !important; + padding: 32px 0; + + img { + max-width: 100%; + } + + .section-inner-content { + margin-bottom: 16px; + } + } + } + } +} + @media only screen and (max-width: $palm-end) { $landingpage__hero_height: 500px; #landingpage { .site-header { background-color: #ffffffe8; - transition: background 0.5s; + transition: background-color 0.5s; ul { margin: 0 4px; @@ -962,30 +983,6 @@ $ha__primary_color: #03a9f4; .wide { line-height: 1em; } - - } - - .section-content { - width: 100%; - padding: 32px 8px; - - .header { - width: 100%; - } - - .section-inner { - flex-direction: column-reverse !important; - padding: 32px 0; - - img { - max-width: 100%; - } - - .section-inner-content { - margin-bottom: 16px; - width: 100%; - } - } } .button-row-with-icon { @@ -998,6 +995,14 @@ $ha__primary_color: #03a9f4; } } + .section-content { + .section-inner { + .section-inner-content { + width: 100%; + } + } + } + .content { margin: 0 8px; diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss index 25dc5a0177a..5b2958aa176 100644 --- a/sass/custom/_paulus.scss +++ b/sass/custom/_paulus.scss @@ -109,9 +109,9 @@ a.integration-alert { .material-card { background-color: #fefefe; - border-radius: 2px; - box-shadow: 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 1px 5px 0 rgba(0, 0, 0, 0.12), - 0 3px 1px -2px rgba(0, 0, 0, 0.2); + border-radius: 8px; + border: 1px solid rgba(0, 0, 0, .12); + box-shadow: rgba(0,0,0,0.06) 0 0 10px; h1 { font-family: Roboto, Noto, sans-serif; @@ -155,10 +155,6 @@ a.integration-alert { } .feedback { - box-shadow: none; - border: 1px solid rgba(0, 0, 0, .12); - border-radius: 4px; - h4 { margin: 0 0 8px !important; @@ -175,9 +171,6 @@ a.integration-alert { } .installation-survey { - box-shadow: none; - border: 1px solid rgba(0, 0, 0, .12); - border-radius: 4px; padding-bottom: 64px; h4 { @@ -189,16 +182,13 @@ a.integration-alert { } } - .links a { - font-weight: 400; - text-transform: none; + p { + margin-bottom: 8px; } } -.survey-button { - padding-top: 8px; - button { +.button { position: relative; cursor: pointer; font-size: 14px; @@ -207,10 +197,11 @@ a.integration-alert { color: #fff; background-color: #03a9f4; border: none; + text-decoration: none !important; border-radius: 4px; box-shadow: 0 2px 2px 0 rgba(0,0,0,.14), 0 3px 1px -2px rgba(0,0,0,.12), 0 1px 5px 0 rgba(0,0,0,.2); - } - button::before { + + &::before { content: " "; position: absolute; top: 0; @@ -220,29 +211,29 @@ a.integration-alert { opacity: 0.2; border-radius: 4px; } - button:hover { + &:hover { box-shadow: 0 4px 8px 0 rgba(0,0,0,.14), 0 1px 7px 0 rgba(0,0,0,.12), 0 3px 1px -1px rgba(0,0,0,.2); } - button:hover::before { + &:hover::before { background-color: rgba(255,255,255,.8); } - button:focus { + &:focus { outline: none; } - button:focus::before { + &:focus::before { background-color: white; } - button:active::before { + &:active::before { background-color: grey; } - :host([active]) button { + :host([active]) & { color: rgba(0, 0, 0, 0.38); background-color: rgba(0, 0, 0, 0.12); box-shadow: none; cursor: unset; pointer-events: none; } - .hidden { + &.hidden { display: none; } } @@ -332,13 +323,14 @@ a.integration-alert { background-size: cover; background-position: center; text-decoration: none; + border: none; .caption { padding: 16px 12px 12px; background-color: rgba(0, 0, 0, 0.54); color: white; - border-bottom-left-radius: 2px; - border-bottom-right-radius: 2px; + border-bottom-left-radius: 8px; + border-bottom-right-radius: 8px; display: flex; justify-content: space-between; align-items: center; diff --git a/sass/custom/_syntax.scss b/sass/custom/_syntax.scss index 9d4c79dba1a..5e5418893e1 100644 --- a/sass/custom/_syntax.scss +++ b/sass/custom/_syntax.scss @@ -13,11 +13,8 @@ code.highlighter-rouge { } pre.highlight { - background-color: #FFF; - border: 1px solid #CCC; font-family: "Courier New","DejaVu Sans Mono","Bitstream Vera Sans Mono",monospace; color: #000; - padding: 1em 0px 1em 1em; font-size: 15px; } .highlight .hll { background-color: #ffffcc } diff --git a/source/_includes/installation_survey.html b/source/_includes/installation_survey.html index e7d9065798c..aee02cbc9c1 100644 --- a/source/_includes/installation_survey.html +++ b/source/_includes/installation_survey.html @@ -1,11 +1,15 @@
-

Help us improve Home Assistant

- Have you just installed Home Assistant? The Home Assistant team is looking to talk to you to understand how the installation went. -
- -
+

+ Help us improve Home Assistant +

+

+ Have you just installed Home Assistant? The Home Assistant team is looking + to talk to you to understand how the installation went. +

+ Help now

diff --git a/source/_layouts/landingpage.html b/source/_layouts/landingpage.html index abcb83c9cb8..eed40b67172 100644 --- a/source/_layouts/landingpage.html +++ b/source/_layouts/landingpage.html @@ -48,7 +48,7 @@ layout: page
{{ entry.image_description }}
-
+
{{entry.title}}
{{entry.description}}
{% if entry.read_more %} diff --git a/source/images/installation/generic-x86-64.svg b/source/images/installation/generic-x86-64.svg deleted file mode 100644 index 0e5f4e3ad54..00000000000 --- a/source/images/installation/generic-x86-64.svg +++ /dev/null @@ -1,274 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - x86-64 - - - - - - - - - - - - - - - - - - - - diff --git a/source/images/installation/green-logo-square.png b/source/images/installation/green-logo-square.png deleted file mode 100644 index 55b53dd17d7..00000000000 Binary files a/source/images/installation/green-logo-square.png and /dev/null differ diff --git a/source/images/installation/green.jpg b/source/images/installation/green.jpg index f3fc62dce63..34768c4265a 100644 Binary files a/source/images/installation/green.jpg and b/source/images/installation/green.jpg differ diff --git a/source/images/installation/macos.svg b/source/images/installation/macos.svg new file mode 100644 index 00000000000..2359d7614d9 --- /dev/null +++ b/source/images/installation/macos.svg @@ -0,0 +1,280 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/source/images/installation/odroid.jpg b/source/images/installation/odroid.jpg new file mode 100644 index 00000000000..3729a0d9f81 Binary files /dev/null and b/source/images/installation/odroid.jpg differ diff --git a/source/images/installation/odroid.png b/source/images/installation/odroid.png deleted file mode 100644 index 4b89913a6c6..00000000000 Binary files a/source/images/installation/odroid.png and /dev/null differ diff --git a/source/images/installation/rpi.jpg b/source/images/installation/rpi.jpg new file mode 100644 index 00000000000..d2a8a103d05 Binary files /dev/null and b/source/images/installation/rpi.jpg differ diff --git a/source/images/installation/windows.svg b/source/images/installation/windows.svg new file mode 100644 index 00000000000..d0332d415c3 --- /dev/null +++ b/source/images/installation/windows.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/source/images/installation/x86.jpg b/source/images/installation/x86.jpg new file mode 100644 index 00000000000..417e768c206 Binary files /dev/null and b/source/images/installation/x86.jpg differ diff --git a/source/images/installation/yellow-logo-square.png b/source/images/installation/yellow-logo-square.png deleted file mode 100644 index ddcfcaf07c7..00000000000 Binary files a/source/images/installation/yellow-logo-square.png and /dev/null differ diff --git a/source/images/installation/yellow.jpg b/source/images/installation/yellow.jpg new file mode 100644 index 00000000000..7d199cb6af4 Binary files /dev/null and b/source/images/installation/yellow.jpg differ diff --git a/source/installation/index.html b/source/installation/index.html index 5718537d314..500f6c69ddb 100644 --- a/source/installation/index.html +++ b/source/installation/index.html @@ -6,263 +6,535 @@ show_title: true toc: true --- -{% include installation_survey.html %} -
-

- The first step is to install Home Assistant. We recommend a dedicated system to run Home Assistant. - If you are unsure of what to choose, follow the Raspberry Pi guide to - install Home Assistant Operating System. -

-

- Home Assistant offers four different installation methods. We recommend using one of the following two methods: -

-
    -
  • Home Assistant Operating System: Minimal Operating System optimized to power Home Assistant. - It comes with Supervisor to manage Home Assistant Core and Add-ons. Recommended installation method.
  • -
  • Home Assistant Container: Standalone container-based installation of Home Assistant Core (e.g. Docker).
  • -
-

There are two alternative installation methods available for experienced users:

-
    -
  • Home Assistant Supervised: Manual installation of the Supervisor.
  • -
  • Home Assistant Core: Manual installation using Python virtual environment.
  • -
-

- The list below shows the installation method available based on the device and platform being used. -

- -

- If you are using the Home Assistant Blue, the Home Assistant Operating System is - already installed. Continue to onboarding. -

+

+ The first step to getting started with Home Assistant is to install it on a + device. There are many ways to run it for all kinds of scenarios and all + kinds of skill levels. +

-

Home Assistant Green

- -
-
-
- -
-
- Home Assistant Green -
    -
  • Home Assistant Operating System
  • -
-
-
- {% include assets/chevron_right.html %} -
-
-

Home Assistant Yellow

- -
-
-
- -
-
- Home Assistant Yellow -
    -
  • Home Assistant Operating System
  • -
-
-
- {% include assets/chevron_right.html %} -
-
-

Raspberry Pi

- -
-
-
- -
-
- Raspberry Pi -
    -
  • Home Assistant Operating System
  • -
  • Home Assistant Container
  • -
  • Home Assistant Core
  • -
-
-
- {% include assets/chevron_right.html %} -
-
+ Easiest -

ODROID

- -
-
-
- -
-
- ODROID -
    -
  • Home Assistant Operating System
  • -
  • Home Assistant Container
  • -
  • Home Assistant Core
  • -
-
-
- {% include assets/chevron_right.html %} -
-
+

Plug and play with Home Assistant Green

+

+ The affordable Home Assistant Green is the easiest way to start using + Home Assistant. It's plug-and-play and comes with Home Assistant already + installed. +

-

Generic x86-64

- -
-
-
- -
-
- Generic x86-64 (e.g. Intel NUC) -
    -
  • Home Assistant Operating System
  • -
  • Home Assistant Container
  • -
  • Home Assistant Core
  • -
-
-
- {% include assets/chevron_right.html %} +
+
+
+
+
-
- -

Windows

- - -

Linux

- -
-
-
- -
-
- Linux -
    -
  • Home Assistant Operating System (VM)
  • -
  • Home Assistant Container
  • -
  • Home Assistant Core
  • -
  • Home Assistant Supervised
  • -
-
+ Easy + +

DIY with Raspberry Pi

+

+ Raspberry Pi, a mini low-cost computer, is one of the most popular platforms + for running Home Assistant. If you want to learn how to DIY, this is a good + way to start and gain experience. +

+ +
+ + Intermediate + +

Extend with Home Assistant Yellow

+

+ The extensible Home Assistant Yellow comes with all the ingredients you need + to help you build a robust smart home. All you need to do is to bring your + own Raspberry Pi Compute Module. +

+ +
+
+
+
+ +
+
+

Home Assistant Yellow

+

The powerful way to run Home Assistant

+
+
+ SKILLS REQUIRED +
    +
  • You're comfortable following instructions on:
  • +
  • Installing a compute module and a heat sink
  • +
  • Flashing a Raspberry Pi
  • +
+
+
+ TOOLS REQUIRED +
    +
  • Raspberry Pi Compute Module 4
  • +
  • Ethernet connection
  • +
  • USB storage drive
  • +
  • Screwdriver
  • +
+
+
+ +
+
+
+
+ + Hard + +

Install on other hardware

+

+ Home Assistant can be repurposed and installed on various hardware, such + as an Odroid or a generic x86-64 machine. The Home Assistant Operating System + allows you to install Home Assistant on these devices even if you have + little to no Linux experience. +

+ +
+
+
+
+ +
+
+

Install Home Assistant on Odroid devices

+

A more powerful alternative to Raspberry Pi

+
+
+ SKILLS REQUIRED +
    +
  • You're comfortable following instructions on:
  • +
  • Writing boot images
  • +
  • Installing an SD card or eMMC
  • +
+
+
+ TOOLS REQUIRED +
    +
  • An Odroid device
  • +
  • MicroSD card or eMMC
  • +
  • Ethernet connection
  • +
+
+
+ +
+
+
+
+ +
+
+
+
+ +
+
+

Install Home Assistant on x86-64 machines

+

Repurpose workstation hardware to run Home Assistant

+
+
+ SKILLS REQUIRED +
    +
  • You can use a command line and install a boot medium on your hardware
  • +
  • You're comfortable configuring the BIOS based on instructions.
  • +
+
+
+ TOOLS REQUIRED +
    +
  • An x86-64 machine
  • +
  • Storage hard drive
  • +
  • USB stick
  • +
  • Ethernet connection
  • +
+
+
+ +
+
+
+
+ + Expert + +

Advanced installation methods

+

+ Home Assistant offers four different installation methods. We recommend + using Home Assistant Operating System, but other methods are available for + experienced users for their specific needs, for example, running Home + Assistant in a virtualized environment (e.g. Proxmox), or on top of an + existing operating system (e.g. Windows, macOS, Linux): +

+
    +
  • + Home Assistant Container: Standalone container-based installation + of Home Assistant Core (e.g. Docker). +
  • +
  • + Home Assistant Supervised: Manual installation of the Supervisor. +
  • +
  • + Home Assistant Core: Manual installation using Python virtual + environment. +
  • +
+

+ Note that while these installation methods may provide some + features for advanced users, they may also have some major limitations. + For example, add-ons and other important Home Assistant features may not be available. Compare + installation methods here. +

+ +
+
+
+
+ +
+
+

Install Home Assistant on Linux

+

Use Home Assistant OS, Container, Supervised, or Core

+
+
+ SKILLS REQUIRED +
    +
  • Advanced knowledge of Linux
  • +
  • Using Linux command line
  • +
  • Using Docker Compose (for HA Container)
  • +
+
+
+ TOOLS REQUIRED +
    +
  • Machine with Linux installed
  • +
+
+
+ +
+
+
+
+ +
+
+
+
+ +
+
+

Install Home Assistant on macOS

+

Use Home Assistant OS on a VM, or install Core

+
+
+ SKILLS REQUIRED +
    +
  • Advanced knowledge of macOS
  • +
  • Using macOS command line
  • +
+
+
+ TOOLS REQUIRED +
    +
  • Machine with macOS installed
  • +
+
+
+ +
+
+
+
+ +
+
+
+
+ +
+
+

Install Home Assistant on Windows

+

Use Home Assistant OS on a VM, or Core on WSL

+
+
+ SKILLS REQUIRED +
    +
  • Know how to find an IP address on your router
  • +
  • Advanced knowledge of Windows
  • +
  • Using Linux command line
  • +
+
+
+ TOOLS REQUIRED +
    +
  • Machine with Windows installed
  • +
  • VirtualBox (for VM)
  • +
  • Windows Subsystem for Linux (for Core)
  • +
+
+
+ +
+
+
+
+ +
+
+
+
+
+
+

Install Home Assistant on other systems

+

Use Home Assistant on virtual machines, NAS, and more

+
+
+ SKILLS REQUIRED +
    +
  • Know how to find an IP address on your router
  • +
  • Advanced knowledge of Windows
  • +
  • Using Linux command line
  • +
+
+
+ TOOLS REQUIRED +
    +
  • Machine with Windows installed
  • +
  • VirtualBox (for VM)
  • +
  • Windows Subsystem for Linux (for Core)
  • +
+
+
+ +
+
+
+

Compare installation methods

- - +
+
HA OS1Container1Core1Supervised1
+ + + + + - - + + + + + - - + + + + + - - + + + + + - - + + + + + - - + + + + + - - + + + + + - - + + + + + - - + + + + + - - + + + + + - - + + + + + -
HA OS1Container1Core1Supervised1
AutomationsAutomations
DashboardsDashboards
IntegrationsIntegrations
BlueprintsBlueprints
Uses containerUses container
Supervisor + Supervisor +
Add-onsAdd-ons
Backups22Backups22
Managed Restore33Managed Restore33
Managed OSManaged OS
+ +
-1: Names are abbreviated. The full names of the installation methods are:
    +1: Names are abbreviated. The full names of the installation methods are: +
    • Home Assistant Operating System
    • Home Assistant Container
    • Home Assistant Core
    • Home Assistant Supervised
    • -
    +

-2: Backups for Home Assistant Core and Home Assistant Container is provided by the backup integration.

+ 2: Backups for Home Assistant Core and Home Assistant Container is provided + by the + backup integration. +

-3: Backups for Home Assistant Core and Home Assistant Container are either a tool to migrate to HAOS or a completely manual restore of the backup.

+ 3: Backups for Home Assistant Core and Home Assistant Container are either + a tool to migrate to HAOS or a completely manual restore of the backup. +

+ +

We get commissions for purchases made through links in this post.