· Colinch NAS · 6 min read

TrueNAS Home Assistant 앱 종료 예고 - VM으로 옮기는 백업·복구 순서

TrueNAS Apps의 Home Assistant 2026.8.3 앱이 2026년 11월 26일 제거될 예정이다. 기존 설정과 PostgreSQL 이력을 보존하면서 Home Assistant OS VM으로 이전하는 실제 점검 순서를 정리한다.

TrueNAS 홈서버에서 Home Assistant OS 가상머신으로 이전하는 구성

그림에서 봐야 할 부분은 저장소와 스마트홈 제어기가 한 장비에 있어도 Home Assistant를 별도 VM으로 분리하면 네트워크와 업데이트를 관리하기 쉽다는 점이다.

TrueNAS Apps의 **Home Assistant 앱은 2026년 8월 26일 deprecated(지원 중단 예고)**로 표시됐고, 공식 카탈로그의 제거 예정일은 2026년 11월 26일이다. 현재 앱 버전은 2026.8.3이지만 새 설치라면 Home Assistant OS를 KVM 가상머신으로 올리는 편이 낫다. 기존 사용자는 백업만 만들고 앱을 지우면 안 된다. 앱의 PostgreSQL 기록과 장기 통계는 일반 Home Assistant 백업에 포함되지 않는다.

이전 구성을 잡는 기준

TrueNAS SCALE 25.10.6, ZFS 풀, RAM 8GB 이상인 미니PC를 기준으로 했다. VM은 CPU 2코어, 메모리 4GB, 디스크 32GB로 시작하면 조명·센서 자동화에 충분하다. 카메라 기록까지 많으면 6GB를 배정한다.

항목기존 앱Home Assistant OS VM
설치Apps 카탈로그KVM .qcow2 이미지
애드온카탈로그 의존Supervisor에서 관리
검색·연결mDNS·Matter가 네트워크 영향을 받음브리지 네트워크·USB 패스스루
데이터HA 설정 + PostgreSQLHA 백업 + VM 백업

TrueNAS는 VM 전환 이유로 mDNS, SSDP, Bluetooth, HomeKit, Thread/Matter 검색과 Zigbee·Z-Wave USB 패스스루를 안내한다. 컨테이너 네트워크를 바꾼 뒤 ESPHome 장치 검색이 늦어졌던 환경이라면 특히 차이가 난다.

앱 삭제 전 백업

Home Assistant에서 설정 → 시스템 → 백업으로 전체 백업을 만들고 PC나 다른 풀에 내려받는다. 이어 앱의 PostgreSQL을 별도로 덤프한다. 컨테이너 이름과 DB 사용자는 설치 환경마다 다르므로 TrueNAS 앱 상세 화면에서 먼저 확인한다.

# 실제 컨테이너 이름을 확인한다.
docker ps --format '{{.Names}}'

# 아래 이름과 DB 값은 실제 환경에 맞게 바꾼다.
docker exec -t home-assistant-postgres \
  pg_dump -U home-assistant -d home-assistant \
  > /mnt/tank/backup/ha-postgres-2026-08-28.sql

TrueNAS Apps에서 Docker 명령이 바로 실행되지 않으면 앱의 Shell 메뉴나 카탈로그 문서를 이용한다. 이름을 추측해 덤프하면 0바이트 파일만 남는 경우가 있다. 백업 파일은 TrueNAS 풀 한 곳에만 두지 않는다.

Home Assistant OS VM 만들기

Home Assistant 공식 Linux 설치 페이지에서 KVM용 .qcow2 이미지를 내려받는다. TrueNAS의 Virtualization → Virtual Machines → Add에서 아래처럼 설정한다.

설정값
펌웨어UEFI
CPU·RAM2 vCPU·4096MB
디스크내려받은 qcow2 이미지
네트워크브리지 + DHCP
VNC설치할 때만 활성화

VM 디스크는 tank/vm/home-assistant처럼 별도 데이터셋에 둔다. VM을 시작하고 공유기 DHCP 목록에서 IP를 확인한 뒤 http://할당된-IP:8123으로 접속한다. 온보딩 화면에서 기존 전체 백업을 복원하면 된다.

Zigbee 코디네이터는 VM 편집 화면의 USB 장치에서 하나만 선택한다. TrueNAS 앱이나 Zigbee2MQTT 컨테이너가 같은 동글을 동시에 잡으면 adapter not found가 발생한다. 복원 후 설정 → 시스템 → 하드웨어에서 동글을 확인하고, 센서 이벤트와 자동화 한 개를 실제로 실행한다.

삭제 시점과 점검표

VM에서 장치, 자동화, Matter·ESPHome 검색이 모두 정상일 때 기존 앱을 삭제한다. 다른 VLAN의 장치가 안 보이면 Home Assistant 문제가 아니라 방화벽과 mDNS 반사 설정일 수 있다. VM 스냅샷만 백업으로 믿지 말고, 복원된 VM에서 새 HA 백업을 만든 뒤 다른 위치에 복사한다.

  • 전체 HA 백업을 PC 또는 다른 풀에 저장
  • PostgreSQL 덤프 파일 크기 확인
  • VM 브리지 IP와 8123 접속 확인
  • Zigbee 동글을 VM 하나에만 연결
  • 자동화·장치 검색·기록 화면 테스트

TrueNAS의 Home Assistant 앱은 2026년 11월 26일 제거 예정이므로 지금 즉시 멈추는 것은 아니다. 새 설치는 HAOS VM으로 시작하고, 기존 사용자는 전체 백업 → PostgreSQL 덤프 → VM 복원 → Zigbee·Matter 테스트 → 앱 삭제 순서로 옮기면 된다. 참고 자료는 TrueNAS Home Assistant 카탈로그와 Home Assistant Linux/VM 설치 문서다.

Share:
Back to Blog