Clear up space: rephrase to use numbered steps (#33516)

This commit is contained in:
c0ffeeca7 2024-07-05 17:33:44 +02:00 committed by GitHub
parent f17970e941
commit 4e039ebaa4
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -1,49 +1,76 @@
--- ---
title: "Clear up storage" title: "Clear up storage"
description: "More information on how to clear up storage in Home Assistant." description: "More information on how to clear up storage in Home Assistant."
related:
- docs: /integrations/recorder/#service-purge
title: purge the contents of the database
- docs: /common-tasks/os/#network-storage
title: Add network storage
- docs: /common-tasks/os/#using-external-data-disk
title: Using an external data disk
- URL: https://yellow.home-assistant.io/guides/add-ssd-existing-installation/
title: Adding an SSD to Home Assistant Yellow
--- ---
Reaching your storage limit, this page will help you when that happens. Reaching your storage limit, this page will help you when that happens.
There are several things you can do to free up some space: There are several things you can do to free up some space:
- [Clean the database](#clean-the-database) - [Clean the database](#cleaning-the-database)
- [Delete old backups](#delete-old-backups) - [Reduce space used for backups](#reducing-space-used-for-backups)
- [Uninstall unused add-ons](#uninstall-unused-add-ons) - [Uninstall unused add-ons](#uninstalling-unused-add-ons)
- [Last resort](#last-resort) - [Expand storage](#expanding-storage)
## Clean the database ## Cleaning the database
The Home Assistant database can get huge! The Home Assistant database can get huge!
Luckily there is a tool you can use to [purge the contents of the database](/integrations/recorder/#service-purge) Luckily, there is a tool you can use to [purge the contents of the database](/integrations/recorder/#service-purge)
You can [filter](/integrations/recorder/#configure-filter) what you send to You can [filter](/integrations/recorder/#configure-filter) what you send to
the database, and even change how long it stores the data the database, and even change how long it stores the data
[with the `purge_keep_days` setting](/integrations/recorder/#purge_keep_days) [with the `purge_keep_days` setting](/integrations/recorder/#purge_keep_days)
## Delete old backups ## Reducing space used for backups
Open the Home Assistant UI and go to {% my backup title="Settings > System > Backups" %}, here you will see all your backups, ### Deleting obsolete backups
these can be downloaded and placed somewhere safe. When you have done that, you can delete
them in the UI and it will free up some space for you.
## Uninstall unused add-ons Previous backups are not included when you create a new one. But they do take up space. To delete old backups, follow these steps:
1. Go to {% my backup title="**Settings** > **System** > **Backups**" %}.
2. From the list of backups, select all the ones you want to delete, then select **Delete selected backups**.
- This clears up space in Home Assistant.
### Storing backups outside of Home Assistant
Storing backups outside of Home Assistant makes sure they don't use space on Home Assistant to begin with. It also makes sure you can [restore Home Assistant from backup](/common-tasks/os/#restoring-a-backup) in case you have an issue with your current installation.
1. Go to {% my backup title="**Settings** > **System** > **Backups**" %}, and from the list of backups, select the backup you want to keep.
2. In the dialog, select the checkbox for each component, in the three-dots menu, select **Download backup**.
3. Store the backup somewhere safe.
- For example, [add network storage](/common-tasks/os/#network-storage), and then [change your default backup location](/common-tasks/os/#change-default-backup-location).
## Uninstalling unused add-ons
Add-ons can take a lot of space, not just the add-on itself but also their data. Add-ons can take a lot of space, not just the add-on itself but also their data.
Open the Home Assistant UI and go to {% my supervisor title="Settings > Add-ons" %} in the sidebar. Here you will see 1. Go to {% my supervisor title="**Settings** > **Add-ons**" %}.
all your installed add-ons, maybe you have some that you no longer use, if 2. Look at your installed add-ons and identify the ones you no longer use.
you do those can be uninstalled to free up some space. 3. To remove the add-on, select the add-on and select **Uninstall**.
## Last resort ## Expanding storage
If all else fails, you need to expand your storage. If the above steps to free up space did not help, you need to expand your storage.
### Expanding storage: Home Assistant Operating System
When you are running {% term "Home Assistant Operating System" %}, you can use the following options to expand your storage:
- Replace your current storage medium, for example, the SD card, with a bigger one. Use a backup to [restore Home Assistant from backup](/common-tasks/os/#restoring-a-backup) on the new SD card.
- [Use an external data disk](/common-tasks/os/#using-external-data-disk)
### Expanding storage on VM
If you are running Home Assistant as a VM, look at the If you are running Home Assistant as a VM, look at the
documentation for your hypervisor on how to expand disks for virtual machines. documentation for your hypervisor on how to expand disks for virtual machines.
Home Assistant will auto-expand to use the newly added space. Home Assistant will auto-expand to use the newly added space.
If you are not running a VM, you need to replace your storage medium
(typically, this will be an SD card). You can use [backups](/common-tasks/os#home-assistant-os-backups) to quickly restore your Home Assistant
installation on a new storage medium.