You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/_includes/installation/operating_system.md
+35-21Lines changed: 35 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -48,6 +48,33 @@ We will need a few things to get started with installing Home Assistant. Links b
48
48
49
49
{% endif %}
50
50
51
+
{% if page.installation_type == 'generic-x86-64' %}
52
+
53
+
<divclass='note'>
54
+
<b>Prerequisites</b>
55
+
56
+
This guide assumes that you have a dedicated generic x86 PC (typically an Intel or AMD-based system) available to exclusively run Home Assistant Operating System. The system must be 64-bit capable and able to boot using UEFI. Pretty much all systems produced in the last 10 years support the UEFI boot mode.
57
+
</div>
58
+
59
+
### Configure the BIOS
60
+
61
+
To boot Home Assistant OS the BIOS needs to have UEFI boot mode enabled and Secure Boot disabled. The following screenshots are from a 7th generation Intel NUC system. The BIOS menu will likely look different on your systems. However, the options should still be present and named similarly.
62
+
63
+
1. Enter the BIOS using the can enter using the `F2` key (on some systems this might be `Del`, `F1` or `F10`).
64
+

As a next step, we need to write the Operating System image to the installation media. Depending on your system this can be a S-ATA hard disk, S-ATA SSD, a M.2 SSD or even a eMMC. Home Assistant Operating System has no integrated installer. You need to use your Desktop computer (e.g. by using a USB to S-ATA adapter) or boot a live operating system on your target system to install Home Assistant Operating System.
73
+
74
+
If you prefer to use a live operating system, follow the instructions of your Live distribution (e.g., [this Ubuntu guide](https://ubuntu.com/tutorials/try-ubuntu-before-you-install)). Once you booted the live operating system, the following steps on how-to write the image to your installation media can be followed.
75
+
76
+
{% endif %}
77
+
51
78
### Write the image to your installation media
52
79
53
80
1. Attach the installation media ({{site.installation.types[page.installation_type].installation_media}}) to your computer
@@ -99,23 +126,21 @@ _Select and copy the URL or use the "copy" button that appear when you hover it.
99
126
100
127
### Start up your {{site.installation.types[page.installation_type].board}}
101
128
129
+
{% if page.installation_type == 'generic-x86-64' %}
130
+
1. If you used your Desktop system to write to your installation media, install the installation media ({{site.installation.types[page.installation_type].installation_media}}) to the target system. Otherwise, shutdown the live operating system and make sure to remove the USB flash drive you have been using for the live system.
131
+
2. Make sure an ethernet cable for network is plugged in
132
+
3. Power the system on.
133
+
{% else %}
102
134
1. Insert the installation media ({{site.installation.types[page.installation_type].installation_media}}) you just created
103
135
2. Attach a ethernet cable for network.
104
136
3. Attach a cable for power
137
+
{% endif %}
105
138
4. Within a few minutes you will be able to reach Home Assistant on <ahref="http://homeassistant.local:8123"target="_blank">homeassistant.local:8123</a>. If you are running an older Windows version or have a stricter network configuration, you might need to access Home Assistant at <ahref="http://homeassistant:8123"target="_blank">homeassistant:8123</a> or `http://X.X.X.X:8123` (replace X.X.X.X with your {{site.installation.types[page.installation_type].board}}’s IP address).
106
139
107
-
108
140
{% else %}
109
141
110
-
{% if page.installation_type != 'generic-x86-64' %}
111
-
Follow this guide if you already are running a hypervisor, if not look at the [Raspberry Pi](/installation/raspberrypi) or the [ODROID](/installation/odroid)
112
-
{% endif %}
113
-
114
142
### Download the appropriate image
115
143
116
-
{% if page.installation_type == 'generic-x86-64' %}
@@ -130,21 +155,12 @@ Follow this guide if you already are running a hypervisor, if not look at the [R
130
155
{% if page.installation_type == 'windows' %}
131
156
-[Hyper-V][vhdx] (.vhdx)
132
157
{% endif %}
133
-
{% endif %}
134
-
{% if page.installation_type == 'generic-x86-64' %}
135
158
136
-
1. Download the operating system from the link above.
137
-
2. Attach the drive you are using in your NUC to your computer.
138
-
3. Download and start <ahref="https://www.balena.io/etcher"target="_blank">Balena Etcher</a>
139
-
4. Select "Flash from File" and choose the image you have just downloaded.
140
-
5. Click "Select Target" and choose the drive you wish to flash too, then click "Flash".
141
-
6. Start the NUC with the drive you installed the operating system to as the boot device.
142
-
7. Once the initial setup has completed you will be able to reach Home Assistant on <ahref="http://homeassistant.local:8123"target="_blank">homeassistant.local:8123</a>. If you are running an older Windows version or have a stricter network configuration, you might need to access Home Assistant at <ahref="http://homeassistant:8123"target="_blank">homeassistant:8123</a> or `http://X.X.X.X:8123` (replace X.X.X.X with your {{site.installation.types[page.installation_type].board}}’s IP address).
143
-
{% else %}
159
+
Follow this guide if you already are running a supported virtual machine hypervisor. If you are not familiar with virtual machines we recommend installation Home Assistant OS directly on a [Raspberry Pi](/installation/raspberrypi) or an [ODROID](/installation/odroid).
144
160
145
161
### Create the Virtual Machine
146
162
147
-
Load the appliance image into your virtual machine software. (Note: You are free to assign as much resources as you wish to the VM, please assign enough based on your add-on needs)
163
+
Load the appliance image into your virtual machine hypervisor. (Note: You are free to assign as much resources as you wish to the VM, please assign enough based on your add-on needs)
148
164
149
165
Minimum recommended assignments:
150
166
@@ -218,8 +234,6 @@ _All these can be extended if your usage calls for more resources._
218
234
219
235
{% endif %}
220
236
221
-
{% endif %}
222
-
223
237
With the Home Assistant Operating System installed and accessible you can continue with onboarding.
224
238
225
239
{% include getting-started/next_step.html step="Onboarding" link="/getting-started/onboarding/" %}
0 commit comments