Clear up storage

Reaching your storage limit, this page will help you when that happens.

There are several things you can do to free up some space:

Viewing the available disk space

Follow these steps to check the available free disk space.

  1. Go to Settings > System > Storage.

  2. Under disk metrics, hover over the status bar to view the details.

    Screenshot of the “Move datadisk” feature

Cleaning the database

The Home Assistant database can become very large. Follow these steps to reduce the size of the database.

  1. To view the size of the current database, go to Settings > System > Repairs.
    • Select the three dots menu and select System information.
    • Scroll down to the Recorder, and check the Estimated database size (MiB).
  2. Purge the contents of the database.
  3. To slow down the growth of the database, filter what you send to the database.
  4. Change how long it stores the data, using the purge_keep_days setting.

Reducing space used for backups

Deleting obsolete backups

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 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 in case you have an issue with your current installation.

  1. Go to 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.

Uninstalling unused add-ons

Add-ons can take a lot of space, not just the add-on itself but also their data.

  1. Go to 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.

Expanding 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 Home Assistant Operating SystemHome Assistant OS, the Home Assistant Operating System, is an embedded, minimalistic, operating system designed to run the Home Assistant ecosystem. It is the recommended installation method for most users. [Learn more], you can use the following options to expand your storage:

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.