Recorder and backups

Recorder and backups

Recorder cleanup

Hass-Cleaner uses Home Assistant's official recorder.purge action.

Recorder stores historical states and events. The cleanup settings determine how much history remains available.

Days to keep

keep_days specifies how many days of Recorder history should remain.

For example, a value of 10 keeps the most recent ten days and makes older Recorder data eligible for removal.

Consider the history required by:

• dashboards;
• statistics;
• energy monitoring;
• long-term analysis;
• automations using recent history.

Repack

Repack attempts to rewrite the database to reclaim disk space.

It may:

• take a long time;
• temporarily require additional disk space;
• create additional database load.

Repack is disabled by default.

Apply filter

This option applies configured Recorder filters while performing the purge.

Safe Recorder procedure

1. Preferably create a full Home Assistant backup.
2. Choose a suitable retention period.
3. Leave repack disabled if uncertain.
4. Review the summary.
5. Enter the exact confirmation PURGE.
6. Start the action.
7. Check history, statistics and dashboards afterwards.

Recorder cleanup is separate from file quarantine and registry cleanup.

Backup options

A scan does not require a backup.

Before a modifying action, Hass-Cleaner can offer:

1. a Supervisor-verified full backup;
2. confirmation of a recent backup checked by the user;
3. consciously proceeding without a backup.

The chosen option is written to the audit log.

Verified backups

Hass-Cleaner starts and checks backups through the permitted Supervisor backup API.

Recent verified backup evidence can be reused for up to 24 hours.

A verified backup is strongly recommended but is not an absolute requirement. Continuing without one requires additional acknowledgement.