Como fazer backup parcial e migrar apenas um app no Home Assistant

Se você gerencia automações complexas em YAML e precisa mover um único aplicativo específico do seu Home Assistant para outra máquina, sabe que a ideia de restaurar o sistema inteiro não faz o menor sentido.

Com as mudanças recentes no sistema, fazer esse backup isolado exige um pequeno truque, mas o processo é direto. Vamos ver exatamente como extrair esse app e transportá-lo de forma rápida e segura para um novo ambiente.

Passo 1: Como criar o backup

No grande update do Home Assistant 2025.1, o sistema de backups foi todo reformulado. A clássica tela para escolher um “Backup Parcial” desapareceu do menu principal para dar lugar a backups completos automatizados. Além disso, os antigos “Add-ons” agora são chamados simplesmente de “Apps”.

Mas não se preocupe, a função continua lá por debaixo dos panos! Para fazer o backup de apenas um app, usaremos as ferramentas de desenvolvedor:

1. No menu lateral, vá em Ferramentas de Desenvolvedor > Ações.
2. Mude a visualização para o modo YAML.
3. Cole o código abaixo. Lembre-se de substituir seu_app_slug pelo identificador exato do aplicativo que você quer salvar (você pode encontrar esse slug olhando a URL no navegador quando está na página do app em Configurações > Apps).

action: hassio.backup_partial
data:
  name: "Backup do Meu App"
  homeassistant: false
  apps:
    - seu_app_slug 

Dica: Note o uso da chave apps. A antiga chave addons está sendo aposentada para refletir a nova nomenclatura!

Clique em Executar Ação. O Home Assistant vai trabalhar silenciosamente e, em instantes, seu backup focado apenas nesse app será gerado.

Passo 2: Resgatando o arquivo do sistema original

Agora que o backup foi criado, precisamos tirá-lo de dentro do seu Home Assistant atual e salvá-lo no seu computador. O sistema empacota esses dados em um formato de arquivo compactado com a extensão .tar.

1. Ainda no seu Home Assistant original, navegue até Configurações > Sistema > Backups.
2. Encontre o backup que acabamos de criar via YAML (com o nome que você definiu) e clique nele.
3. Clique na opção de Download (ou acesse o menu de três pontos e depois clique em Download).
4. Salve o arquivo .tar em uma pasta de fácil acesso no seu computador.

Passo 3: Preparando o terreno

Este passo é o verdadeiro pulo do gato. Se o aplicativo que você está movendo faz parte da loja oficial do Home Assistant (como o Node-RED ou o File Editor), você pode pular direto para o Passo 4.

Porém, se for um aplicativo de terceiros (desenvolvido pela comunidade e hospedado no GitHub, por exemplo), o novo Home Assistant precisa saber “de onde” baixar a base desse app antes de conseguir injetar as suas configurações antigas nele.

1. No novo Home Assistant, vá em Configurações > Apps > Loja de Apps.
2. Clique nos três pontinhos no canto superior direito e selecione Repositórios.
3. Adicione o link do repositório desse app específico e confirme.

Passo 4: Subindo e Restaurando no Novo Sistema

O novo sistema já conhece o caminho (caso seja um app customizado) e você já tem o arquivo de backup em mãos. É hora de fazer a mágica acontecer!

1. No novo Home Assistant, navegue até Configurações > Sistema > Backups.
2. No canto superior direito, clique no menu de três pontos e escolha Fazer upload de backup. Na maioria das interfaces, você pode simplesmente arrastar e soltar o arquivo .tar na tela.
3. Selecione o arquivo .tar que você baixou no Passo 2.
4. Assim que o upload terminar, o backup vai aparecer na sua lista. Clique nele.
5. Uma janela vai se abrir mostrando o conteúdo do pacote (que deve exibir apenas o seu app solitário e o tamanho dos dados).
6. Clique no botão Restaurar.

Pronto! Agora é só aguardar alguns minutos. Nos bastidores, o Home Assistant vai puxar a imagem do app, descompactar os dados e alinhar todas as suas configurações originais. Quando o processo terminar, o aplicativo vai aparecer perfeitamente configurado na sua aba de Configurações > Apps, pronto para ser usado no novo ambiente.