mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-18 23:06:58 +00:00
Clear up space: rephrase to use numbered steps (#33516)
This commit is contained in:
parent
f17970e941
commit
4e039ebaa4
@ -1,49 +1,76 @@
|
||||
---
|
||||
title: "Clear up storage"
|
||||
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.
|
||||
|
||||
There are several things you can do to free up some space:
|
||||
|
||||
- [Clean the database](#clean-the-database)
|
||||
- [Delete old backups](#delete-old-backups)
|
||||
- [Uninstall unused add-ons](#uninstall-unused-add-ons)
|
||||
- [Last resort](#last-resort)
|
||||
- [Clean the database](#cleaning-the-database)
|
||||
- [Reduce space used for backups](#reducing-space-used-for-backups)
|
||||
- [Uninstall unused add-ons](#uninstalling-unused-add-ons)
|
||||
- [Expand storage](#expanding-storage)
|
||||
|
||||
## Clean the database
|
||||
## Cleaning the database
|
||||
|
||||
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
|
||||
the database, and even change how long it stores the data
|
||||
[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,
|
||||
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.
|
||||
### Deleting obsolete backups
|
||||
|
||||
## 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.
|
||||
|
||||
Open the Home Assistant UI and go to {% my supervisor title="Settings > Add-ons" %} in the sidebar. Here you will see
|
||||
all your installed add-ons, maybe you have some that you no longer use, if
|
||||
you do those can be uninstalled to free up some space.
|
||||
1. Go to {% my supervisor title="**Settings** > **Add-ons**" %}.
|
||||
2. Look at your installed add-ons and identify the ones you no longer use.
|
||||
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
|
||||
documentation for your hypervisor on how to expand disks for virtual machines.
|
||||
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.
|
||||
|
Loading…
x
Reference in New Issue
Block a user