mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-19 15:26:59 +00:00
Update procedure on HAOS installation on x86_64 (#21554)
Co-authored-by: Stefan Agner <stefan@agner.ch> Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
c0ffeeca7
GitHub
parent
7b5c513912
commit
23c74e1051
@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
{% if site.installation.types[page.installation_type].board %}
|
{% if site.installation.types[page.installation_type].board %}
|
||||||
|
|
||||||
Follow this guide if you want to get started with Home Assistant easily or if you have little to no Linux experience
|
Follow this guide if you want to get started with Home Assistant easily or if you have little to no Linux experience.
|
||||||
|
|
||||||
{% if page.installation_type == 'raspberrypi' %}
|
{% if page.installation_type == 'raspberrypi' %}
|
||||||
|
|
||||||
@ -57,25 +57,39 @@ This guide assumes that you have a dedicated generic x86 PC (typically an Intel
|
|||||||
|
|
||||||
<b>Summary</b>
|
<b>Summary</b>
|
||||||
|
|
||||||
You will need to write the HAOS (Home Assistant OS) disk image directly to your boot media, and then configure your x86 to boot from this media, using UEFI boot mode.
|
You will need to write the HAOS (Home Assistant OS) disk image directly to your boot media, and configure your x86 to use UEFI boot mode when booting from this media.
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
### Configure the BIOS
|
### Configure the BIOS on your x86-64 hardware
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
1. Enter the BIOS using the can enter using the `F2` key (on some systems this might be `Del`, `F1` or `F10`).
|
1. To enter the BIOS, start up your x86-64 hardware and repeatedly press the `F2` key (on some systems this might be `Del`, `F1` or `F10`).
|
||||||
|
|
||||||
|
|
||||||
1. Make sure the UEFI Boot mode is enabled
|
1. Make sure the UEFI Boot mode is enabled.
|
||||||
|
|
||||||
|
|
||||||
1. Disable Secure Boot
|
1. Disable Secure Boot.
|
||||||
|
|
||||||
|
|
||||||
As a next step, we need to write the Operating System image to the target boot media (Your "boot media" is the disk, SSD, or eMMC that your x86-64 hardware will boot from when it is running Home Assistant). 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, by writing the disk image directly onto the boot media for your x86 system.
|
1. Save the changes and exit.
|
||||||
|
|
||||||
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 boot media can be followed.
|
- The BIOS configuration is complete.
|
||||||
|
|
||||||
|
As a next step, we need to write the Home Assistant Operating System image to the target boot medium. The HAOS has no integrated installer. This means the Operating System is not copied automatically to the internal disk.
|
||||||
|
|
||||||
|
- The "boot medium" is the medium your x86-64 hardware will boot from when it is running Home Assistant.
|
||||||
|
- Typically, an internal medium is used for the x86-64 hardware. Examples of internal media are S-ATA hard disk, S-ATA SSD, M.2 SSD, or a non-removable eMMC.
|
||||||
|
- Alternatively, an external medium can be used to boot HAOS such as a USB SDD (not recommended).
|
||||||
|
|
||||||
|
To install the HAOS internally on your x86-64 hardware, there are 2 methods:
|
||||||
|
|
||||||
|
1. Copying the HAOS disk image from your Desktop computer onto your boot medium (e.g. by using a USB to S-ATA adapter). This is not an option for a non-removable eMMC on your x86-64 hardware, of course.
|
||||||
|
To use this method, follow the steps described in the procedure below: [Write the image to your boot media](#write-the-image-to-your-boot-media).
|
||||||
|
2. Copying a live operating system (e.g. Ubuntu) onto a USB device. Then, insert this USB device into your x86-64 hardware and start the Ubuntu.
|
||||||
|
|
||||||
|
- To use this method, 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, follow the steps described in the procedure below: [Write the image to your boot media](#write-the-image-to-your-boot-media).
|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
@ -134,15 +148,24 @@ _Select and copy the URL or use the "copy" button that appear when you hover it.
|
|||||||
### Start up your {{site.installation.types[page.installation_type].board}}
|
### Start up your {{site.installation.types[page.installation_type].board}}
|
||||||
|
|
||||||
{% if page.installation_type == 'generic-x86-64' %}
|
{% if page.installation_type == 'generic-x86-64' %}
|
||||||
1. If you used your Desktop system to write to your boot media, install the boot media ({{site.installation.types[page.installation_type].installation_media}}) into 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.
|
|
||||||
2. Make sure an ethernet cable for network is plugged in
|
1. If you used your desktop system to write the HAOS your boot media, install the boot media ({{site.installation.types[page.installation_type].installation_media}}) in the generic-x86-64 system.
|
||||||
|
|
||||||
|
- If you used a live operating system (e.g. Ubuntu), shut down the live operating system and make sure to remove the USB flash drive you used for the live system.
|
||||||
|
|
||||||
|
2. Make sure an Ethernet cable is plugged in for network.
|
||||||
3. Power the system on.
|
3. Power the system on.
|
||||||
|
|
||||||
|
- Wait for the Home Assistant welcome banner to show up in the console of the generic-x86-64 system.
|
||||||
{% else %}
|
{% else %}
|
||||||
1. Insert the boot media ({{site.installation.types[page.installation_type].installation_media}}) you just created
|
|
||||||
2. Attach a ethernet cable for network.
|
1. Insert the boot media ({{site.installation.types[page.installation_type].installation_media}}) you just created.
|
||||||
3. Attach a cable for power
|
2. Attach an Ethernet cable for network.
|
||||||
|
3. Attach the power cable.
|
||||||
{% endif %}
|
{% endif %}
|
||||||
4. Within a few minutes you will be able to reach Home Assistant on <a href="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 <a href="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).
|
4. In the browser of your Desktop system, within a few minutes you will be able to reach your new Home Assistant on <a href="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 <a href="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).
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
@ -167,7 +190,7 @@ Follow this guide if you already are running a supported virtual machine hypervi
|
|||||||
|
|
||||||
### Create the Virtual Machine
|
### Create the Virtual Machine
|
||||||
|
|
||||||
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)
|
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).
|
||||||
|
|
||||||
Minimum recommended assignments:
|
Minimum recommended assignments:
|
||||||
|
|
||||||
@ -246,7 +269,6 @@ With the Home Assistant Operating System installed and accessible you can contin
|
|||||||
|
|
||||||
{% include getting-started/next_step.html step="Onboarding" link="/getting-started/onboarding/" %}
|
{% include getting-started/next_step.html step="Onboarding" link="/getting-started/onboarding/" %}
|
||||||
|
|
||||||
|
|
||||||
[generic-x86-64]: {{release_url}}/{{site.data.version_data.hassos['ova']}}/haos_generic-x86-64-{{site.data.version_data.hassos['generic-x86-64']}}.img.xz
|
[generic-x86-64]: {{release_url}}/{{site.data.version_data.hassos['ova']}}/haos_generic-x86-64-{{site.data.version_data.hassos['generic-x86-64']}}.img.xz
|
||||||
[vmdk]: {{release_url}}/{{site.data.version_data.hassos['ova']}}/haos_ova-{{site.data.version_data.hassos['ova']}}.vmdk.zip
|
[vmdk]: {{release_url}}/{{site.data.version_data.hassos['ova']}}/haos_ova-{{site.data.version_data.hassos['ova']}}.vmdk.zip
|
||||||
[vhdx]: {{release_url}}/{{site.data.version_data.hassos['ova']}}/haos_ova-{{site.data.version_data.hassos['ova']}}.vhdx.zip
|
[vhdx]: {{release_url}}/{{site.data.version_data.hassos['ova']}}/haos_ova-{{site.data.version_data.hassos['ova']}}.vhdx.zip
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user