Quando instalamos o Home Assistant OS em um Mini PC Intel N100 com um SSD NVMe de alta velocidade, a resposta do sistema se torna instantânea. Os gráficos carregam em milissegundos e as automações voam. No entanto, essa velocidade esconde um comportamento silencioso: por padrão, o Home Assistant registra absolutamente tudo o que acontece na casa a cada segundo.
Cada pequena variação na potência de sinal do Wi-Fi de uma lâmpada, cada mudança na porcentagem da bateria de um sensor Zigbee e cada atualização de consumo elétrico são salvas no banco de dados local (home-assistant_v2.db).
Se você tem dezenas de dispositivos inteligentes em casa, esse arquivo de banco de dados começará a inchar em um ritmo alarmante. Em poucos meses, ele pode atingir dezenas de gigabytes, reduzindo a vida útil do seu SSD por excesso de reescrita (TBW) e tornando os backups em nuvem gigantescos e lentos.
Para evitar que o armazenamento do seu Mini PC lote, precisamos assumir o controle do componente de registro do sistema. Vamos aprender a configurar a otimização correta do banco de dados para salvar apenas o que realmente importa para a sua automação.
O Inimigo Oculto: Entendendo o Componente Recorder
O motor responsável por salvar o histórico da sua casa inteligente é o componente chamado Recorder. Se você não alterar as configurações dele, ele operará sob as regras padrão de fábrica do Home Assistant:
- Retenção de 10 Dias: O sistema mantém o histórico detalhado de cada segundo de todos os sensores por dez dias seguidos.
- Purge Automático: A cada madrugada (geralmente às 04:15), o sistema roda uma rotina para apagar os dados mais antigos que o limite de retenção.
- O Problema do Lixo Digital: Sensores irrelevantes (como o status de “conectado” do celular da sua visita ou o uso de memória RAM de cada add-on) geram milhares de linhas de dados inúteis que estressam o SSD sem necessidade.
Para um servidor doméstico saudável rodando no chip N100, a estratégia ideal não é simplesmente apagar o banco de dados, mas sim aplicar filtros cirúrgicos para impedir que o lixo digital chegue até o disco rígido.
Estratégias de Otimização: O que Guardar e o que Descartar?
Para otimizar o seu sistema, divida as entidades da sua residência em dois grupos lógicos:
- Entidades Críticas (Precisam de Histórico): Gráficos de consumo elétrico mensal, histórico de temperatura e umidade da casa, e registros de abertura de portas ou acionamento de alarmes.
- Entidades Descartáveis (Não precisam de Histórico): Sensores de sinal de rádio (LQI e RSSI), volume de som de caixas inteligentes, porcentagem de uso de CPU do Mini PC e atualizações de sensores de uptime (tempo online).
Passo a Passo para Configurar e Compactar o seu Banco de Dados
Toda a otimização do banco de dados é feita editando o arquivo de texto principal do sistema: o configuration.yaml.
1. Instale o Editor de Arquivos (File Editor)
Se você ainda não consegue editar as configurações internas do sistema pelo navegador:
- Vá em Configurações > Sistema > Complementos (Add-ons).
- Clique em Loja de Complementos, localize o add-on File Editor (ou Studio Code Server) e instale-o.
- Ative a opção Mostrar na barra lateral e clique em Iniciar.
2. Configure os Filtros do Recorder no Código
Abra o File Editor pela barra lateral esquerda e selecione o arquivo configuration.yaml. Procure se já existe uma linha escrita recorder:. Se não houver, crie a estrutura do zero no topo do arquivo seguindo o modelo de alta eficiência abaixo:
YAML
recorder:
purge_keep_days: 5
auto_purge: true
exclude:
domains:
– automation
– script
– zone
– update
entity_globs:
– sensor.*_lqi
– sensor.*_rssi
– sensor.*_battery
– sensor.pve_*
entities:
– sensor.sun_next_dawn
– sensor.sun_next_dusk
– sensor.sun_next_midnight
Entendendo o Código Aplicado:
- purge_keep_days: 5: Reduz o tempo de retenção padrão de 10 para 5 dias. Isso corta o tamanho do banco de dados praticamente pela metade de forma imediata. Cinco dias são mais do que suficientes para consultar históricos locais no painel.
- exclude: Diz ao Mini PC exatamente o que ele está proibido de salvar no SSD.
- domains: Bloqueia o registro histórico de execuções de automações e scripts (você ainda poderá usá-los normalmente, o sistema apenas deixará de inflar o banco de dados toda vez que uma luz acender sozinha).
- entity_globs: Usa o caractere coringa * para bloquear de uma só vez todos os sensores de força de sinal de rede (_lqi e _rssi) e níveis de bateria de todos os dispositivos Zigbee da casa.
Clique no ícone de disquete no canto superior direito para Salvar o arquivo.
3. Valide o Código e Reinicie o Sistema
Antes de reiniciar o Mini PC, você deve verificar se não cometeu nenhum erro de digitação ou espaçamento (indentação) no código YAML.
- Vá em Configurações > Ferramentas de Desenvolvedor > aba YAML.
- Clique no botão Verificar Configuração.
- Se o sistema exibir a mensagem verde “A configuração é válida!”, clique no botão Reiniciar localizado logo abaixo.
4. Force a Compactação Física do Banco de Dados (Repack)
Mesmo após aplicar os filtros e o sistema apagar os dados antigos na madrugada, o arquivo de banco de dados do Linux não diminui de tamanho fisicamente sozinho no SSD; ele apenas fica com “espaços em branco” internos. Para recuperar o espaço em disco de forma real, precisamos rodar o serviço de compactação.
- Vá em Ferramentas de Desenvolvedor > aba Serviços (ou Ações).
- No campo de busca, digite e selecione o serviço Recorder: Purge (recorder.purge).
- Marque a caixa Repack (isso forçará o banco de dados a reorganizar as tabelas e devolver o espaço livre para o SSD do Mini PC).
- Clique em Executar Ação. O processador N100 processará essa rotina em poucos segundos em segundo plano.
O Próximo Nível: Separando o Histórico Longo (LTS)
Uma dúvida comum que surge ao reduzir os dias de retenção é: “Se eu configurar para guardar apenas 5 dias, eu vou perder os gráficos de consumo de energia do mês passado?”
A resposta é não. O Home Assistant moderno possui um sistema duplo inteligente. O recorder gerencia apenas os dados detalhados de curto prazo (segundo a segundo). Para dados de longo prazo (como o consumo em kWh da sua casa ou as médias diárias de temperatura), o sistema gera automaticamente as Estatísticas de Longo Prazo (LTS).
As estatísticas de longo prazo realizam uma média de hora em hora dos sensores e as guardam em uma tabela separada e ultra-compactada que nunca é apagada, consumindo quase zero espaço no SSD. Portanto, você pode reduzir o Recorder para 3 ou 5 dias sem medo de perder os seus valiosos relatórios anuais de energia.
O gerenciamento inteligente de dados é o que diferencia um servidor amador instável de uma infraestrutura residencial de alta performance. Deixar o seu Mini PC Intel N100 registrando gigabytes de ruído digital ininterruptamente diminui a velocidade de leitura do drive e acelera o desgaste físico do seu SSD NVMe sem trazer nenhum benefício prático para o seu dia a dia. Ao blindar o arquivo de configuração com regras rígidas de exclusão e reduzir o tempo de retenção para o estritamente necessário, você garante um Home Assistant leve, com backups rápidos em nuvem e um banco de dados otimizado pronto para operar com estabilidade máxima por muitos anos.
