-
-
Notifications
You must be signed in to change notification settings - Fork 8.3k
Clear up space: rephrase to use numbered steps #33516
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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. | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.