Tutorial

Banco de Dados do Home Assistant: Evite Travamentos

Recorder inchado derruba a experiência: histórico lento, painel engasgando e cartão SD sofrendo. A solução começa por retenção e exclusões.

Racks de servidores iluminados, representando banco de dados e desempenho do Home Assistant
Visão geral
DificuldadeMédio
Tempo30-60 min
CustoR$ 0; opcionalmente R$ 150-400 para SSD
DificuldadeMédio
Tempo30-60 min
CustoR$ 0; opcionalmente R$ 150-400 para SSD

O que você vai precisar

Passo a passo

  1. 1. Faça backup antes de mexer no Recorder

    O banco guarda histórico, estatísticas e estados. Antes de reduzir retenção ou excluir entidades, gere um backup completo e confirme que ele aparece no menu de backups.

    Dica: Não otimize sem backup. Banco corrompido não aceita discurso bonito.
  2. 2. Reduza o período de retenção

    No recorder, ajuste purgekeepdays para algo realista. Para a maioria das casas, 7 a 15 dias bastam no histórico detalhado; longo prazo deve ficar nas estatísticas, não no evento bruto.

    Dica: 30 dias de tudo é luxo caro para instalação em hardware fraco.
  3. 3. Exclua entidades barulhentas

    Sensores que mudam a cada segundo, força de sinal, uptime, memória, temperatura interna e telemetria repetitiva inflam o banco. Use include/exclude para gravar só o que interessa.

    Dica: O objetivo não é apagar histórico útil; é parar de gravar ruído.
  4. 4. Mantenha purge e repack ativos

    A documentação do Recorder informa autopurge como padrão e autorepack para recuperar espaço. Se você desligar isso, crie uma automação para chamar recorder.purge periodicamente.

    Dica: Purge remove dado antigo; repack ajuda o arquivo a encolher de verdade.
  5. 5. Troque cartão SD por SSD se a casa cresceu

    Cartão SD sofre com escrita constante. Em instalação com muitas entidades, câmeras e energia, SSD melhora a vida do host e reduz travadas.

    Dica: Se o histórico abriu lento por semanas, o gargalo pode ser armazenamento, não YAML.

Por que uma instalação do Home Assistant que parecia rápida começa a engasgar depois de meses?

O caso clássico é um Raspberry Pi com cartão SD, 800 entidades e sensores atualizando o tempo todo. A lição é simples: o Recorder grava muito mais do que você imagina. A aplicação prática é cortar ruído antes que o banco vire âncora.

A documentação oficial é direta: purgar impede crescimento indefinido, economiza espaço e evita lentidão. O padrão de purgekeepdays é 10. Esse número significa que o histórico detalhado fica por 10 dias, não que você perdeu todas as estatísticas úteis da casa.

O erro é tratar o banco como depósito eterno. Home Assistant não é data warehouse por padrão.

Onde mexer primeiro#

Comece por retenção e exclusões. Depois avalie hardware. Migrar para MariaDB sem limpar entidades barulhentas só muda o problema de lugar.

Quando migrar para SSD#

Se a instalação já tem muitos sensores de energia, câmeras, integrações em nuvem e automações, SSD deixa de ser capricho.

Depois de excluir sensores de ruído e manter 10 dias de histórico, a página de Histórico abre em segundos, não em minutos.

AD
Escrito por
Tutorial · Guias técnicos
Anterior5 Gravadores e Ferramentas para Customizar IoT08 de junho de 2026Próximo5 Firmwares Alternativos para Turbinar Hardware IoT08 de junho de 2026