home-assistant.io/source/common-tasks/os.markdown

title, description, installation, installation_name, related

title	description	installation	installation_name	related
Common tasks - Operating System	Common tasks for Home Assistant Operating System	os	Operating System	docs /docs/configuration/

This section will provide guides to some common tasks and information which you will need in order to run, maintain, and edit your Home Assistant OS system. For further details on any particular subject, make sure to refer to the documentation for specific add-ons or topics listed here.

{% include common-tasks/file_access.md %}

Backup

To learn how to back up the system or how to restore a system from a backup, refer to the backup documentation under common tasks.

Alternative: Creating a backup using the Home Assistant Command Line Interface

In general, to create or restore from a backup, follow the steps described under common tasks. However, If you have the {% term "Home Assistant Operating System" %} installed, you can also create a backup from the command line. Follow these steps:

1. ha backups list - lists backups and their slugnames
2. ha backups restore slugname - restores a specific backup
3. ha backups new --name nameofbackup - create a backup

For additional information about command line usage, use the ha help command or refer to the Home Assistant Command Line documentation.

Updating Home Assistant

If you have the {% term "Home Assistant Operating System" %} installed, you receive update notifications from different components:

• {% term "Home Assistant Operating System" %}
• {% term "Home Assistant Supervisor" %}
• {% term "Home Assistant Core" %}
• {% term "Add-ons" %}, if you have any installed

Each of these components needs to be updated separately.

Updating the Home Assistant Operating System

Updates of the {% term "Home Assistant Operating System" %} are independent of other updates. They do not trigger repair issues and are usually backward-compatible.

Prerequisites

• Backup your installation.
  • Make sure the backup is stored on a backup location outside of the device where Home Assistant is installed.
    • For example, if Home Assistant is installed on Home Assistant Green, make sure it is stored on Home Assistant Cloud or another location.
  • So that you can restore from that backup in case there is an issue with the system.

To update the Home Assistant Operating System

{% tabbed_block %}

• title: Using the UI content: |

  1. Open the Settings panel.
  2. On the top you will be presented with an update notification.
     • Troubleshooting: If you do not see that notification:
       • In the top right corner, select the three dots {% icon "mdi:dots-vertical" %} menu and select Check for updates.
       • Go to {% my updates title="System > Updates" %}.
         • Select the update notification.
         • Select the cogwheel {% icon "mdi:cog-outline" %}, then set Visible to active.
  3. Open the notification for the component you want to update.
  4. If you want to update the system first (recommended), enable the backup toggle.
  5. Select Update.
  6. Check if there are any repair issues and check the logs to see if there are any issues with your configuration that need to be addressed.

• title: Using the CLI content: |

  ha os update
  

  This updates to the latest version. If you want to update to a specific version instead, use ha os update --version 12.0.

{% endtabbed_block %}

{% details "Advanced: changing the boot slot used during the update" %}

About boot slots used during the update

The {% term "Home Assistant Operating System" %} uses two boot slots. On first installation, boot slot A is used. After that, on each Operating System update, the other boot slot is updated and reboot is triggered. On that reboot, the system boots from the other boot slot (A ➝ B ➝ A,...). When booting fails, the system automatically uses the previous boot slot, so that it boots from the last working operating system.

Changing the boot slot used

You can manually define that the previous boot slot is used. This can be useful in cases where the system boots but something still seems wrong. For example, when the device is no longer correctly detected or you see another issue that might be related to the latest update of the operating system.

1. To check which boot slot is currently in use and what OS versions are installed in the individual slots, in the Home Assistant command line, enter the following command:

   ha os info
   

2. To change the boot slot, enter the following command:

   • This will boot into the other (previous) OS version.

   ha os boot-slot other
   

Alternatively, if the Operating Systems runs on a platform that uses the GRUB bootloader, a boot menu is presented early in the boot. The alternative boot slot can be selected here, marking it active for future boots if the following boot attempt is successful.

{% enddetails %}

Updating Home Assistant Core

{% include common-tasks/update.md %}

{% include common-tasks/network_storage.md %} {% include common-tasks/lost_password.md %} {% include common-tasks/third-party-addons.md %} {% include common-tasks/configuration_check.md %}

Home Assistant versions

To see which version your system is running, go to {% my info title="Settings > About" %}.

{% include common-tasks/specific_version.md %} {% include common-tasks/beta_version.md %} {% include common-tasks/development_version.md %}

{% include common-tasks/data_disk.md %}

{% include common-tasks/commandline.md %}

{% include common-tasks/enable_i2c.md %}