{"id":366,"date":"2026-08-09T11:19:36","date_gmt":"2026-08-09T14:19:36","guid":{"rendered":"https:\/\/www.bernabauer.com\/blog\/?p=366"},"modified":"2026-08-09T11:19:36","modified_gmt":"2026-08-09T14:19:36","slug":"como-fazer-backup-parcial-e-migrar-apenas-um-app-no-home-assistant","status":"publish","type":"post","link":"https:\/\/www.bernabauer.com\/blog\/como-fazer-backup-parcial-e-migrar-apenas-um-app-no-home-assistant\/","title":{"rendered":"Como fazer backup parcial e migrar apenas um app no Home Assistant"},"content":{"rendered":"

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.<\/p>\n

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.<\/p>\n

Passo 1: Como criar o backup<\/h2>\n

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”.<\/p>\n

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:<\/p>\n

    \n
  1. No menu lateral, vá em Ferramentas de Desenvolvedor<\/strong> > Ações<\/strong>.<\/li>\n
  2. Mude a visualização para o modo YAML<\/strong>.<\/li>\n
  3. Cole o código abaixo. Lembre-se de substituir seu_app_slug<\/code> pelo identificador exato do aplicativo que você quer salvar (você pode encontrar esse slug<\/em> olhando a URL no navegador quando está na página do app em Configurações > Apps<\/strong>).<\/li>\n<\/ol>\n
    action: hassio.backup_partial\ndata:\n  name: \"Backup do Meu App\"\n  homeassistant: false\n  apps:\n    - seu_app_slug <\/code><\/pre>\n
    \n
    Dica:<\/strong> Note o uso da chave apps<\/code>. A antiga chave addons<\/code> está sendo aposentada para refletir a nova nomenclatura!<\/p>\n<\/blockquote>\n
    Clique em Executar Ação<\/strong>. O Home Assistant vai trabalhar silenciosamente e, em instantes, seu backup focado apenas nesse app será gerado.<\/p>\n
    Passo 2: Resgatando o arquivo do sistema original<\/h2>\n
    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<\/code>.<\/p>\n
      \n
    1. Ainda no seu Home Assistant original, navegue até Configurações<\/strong> > Sistema<\/strong> > Backups<\/strong>.<\/li>\n
    2. Encontre o backup que acabamos de criar via YAML (com o nome que você definiu) e clique nele.<\/li>\n
    3. Clique na opção de Download<\/strong> (ou acesse o menu de três pontos e depois clique em Download<\/em>).<\/li>\n
    4. Salve o arquivo .tar<\/code> em uma pasta de fácil acesso no seu computador.<\/li>\n<\/ol>\n
      Passo 3: Preparando o terreno<\/h2>\n
      Este passo é o verdadeiro pulo do gato.<\/em> Se o aplicativo que você está movendo faz parte da loja oficial do Home Assistant (como o Node-RED<\/em> ou o File Editor<\/em>), você pode pular direto para o Passo 4.<\/p>\n
      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.<\/p>\n
        \n
      1. No novo<\/strong> Home Assistant, vá em Configurações<\/strong> > Apps<\/strong> > Loja de Apps<\/strong>.<\/li>\n
      2. Clique nos três pontinhos no canto superior direito e selecione Repositórios<\/strong>.<\/li>\n
      3. Adicione o link do repositório desse app específico e confirme.<\/li>\n<\/ol>\n
        Passo 4: Subindo e Restaurando no Novo Sistema<\/h2>\n
        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!<\/p>\n
          \n
        1. No novo<\/strong> Home Assistant, navegue até Configurações<\/strong> > Sistema<\/strong> > Backups<\/strong>.<\/li>\n
        2. No canto superior direito, clique no menu de três pontos e escolha Fazer upload de backup<\/strong>. Na maioria das interfaces, você pode simplesmente arrastar e soltar o arquivo .tar<\/code> na tela.<\/li>\n
        3. Selecione o arquivo .tar<\/code> que você baixou no Passo 2.<\/li>\n
        4. Assim que o upload terminar, o backup vai aparecer na sua lista. Clique nele.<\/li>\n
        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).<\/li>\n
        6. Clique no botão Restaurar<\/strong>.<\/li>\n<\/ol>\n
          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<\/strong>, pronto para ser usado no novo ambiente.<\/p>\n","protected":false},"excerpt":{"rendered":"
          Aprenda passo a passo como criar um backup parcial de um \u00fanico aplicativo (add-on) no Home Assistant, transferi-lo com seguran\u00e7a e restaurar em uma nova instala\u00e7\u00e3o sem perder suas configura\u00e7\u00f5es.<\/p>\n","protected":false},"author":2,"featured_media":367,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[6],"tags":[125,122,76,123,124],"class_list":["post-366","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-automacao","tag-add-ons","tag-backup-parcial","tag-home-assistant","tag-migrar-app","tag-yaml"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/www.bernabauer.com\/blog\/wp-content\/uploads\/2026\/08\/como-fazer-backup-parcial-e-migrar-apenas-um-app-no-home-ass-featured.jpg","_links":{"self":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts\/366","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/comments?post=366"}],"version-history":[{"count":1,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts\/366\/revisions"}],"predecessor-version":[{"id":368,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts\/366\/revisions\/368"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/media\/367"}],"wp:attachment":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/media?parent=366"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/categories?post=366"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/tags?post=366"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}