커뮤니티 솔루션

ZimaOS에서 애드온을 포함한 완전한 Home Assistant 실행

A January 2026 ZimaOS discussion clarified that Home Assistant features depend on the installation type, not the ZimaOS version. Docker provides Home Assistant Container without Supervisor/add-ons, while one user confirmed full Home Assistant OS running inside ZVM.

Supervisor, 앱/애드온, 백업 및 Home Assistant가 관리하는 업데이트를 포함한 “완전한” Home Assistant 환경을 원한다면, 핵심 선택 기준은 특정 ZimaOS 버전이 아니라 Home Assistant 설치 유형입니다. 이는 2026년 1월 IceWhale Community 스레드의 핵심 답변이었습니다.

Home Assistant Container는 ZimaOS에서 Docker 애플리케이션으로 정상 실행할 수 있지만, 현재 Home Assistant 문서에는 Container 설치가 Home Assistant 앱에 접근할 수 없다고 명시되어 있습니다. ZimaOS를 유지하면서도 완전한 HAOS 환경을 원한다면, 공식 자료에 근거한 가장 현실적인 절충안은 Home Assistant Operating System을 가상 머신으로 실행하는 것입니다. 한 커뮤니티 사용자는 ZVM 내에서 이렇게 구성했으며 HACS와 애드온에 접근할 수 있다고 보고했습니다.

실용적인 Home Assistant 세 가지 옵션

방법 ZimaOS 유지 여부 Supervisor / 앱 적합한 대상
ZimaOS의 Home Assistant Container 예 아니요 지원 컨테이너를 직접 관리하려는 사용자
ZVM의 Home Assistant OS 예 예 ZimaOS를 유지하면서 완전한 HA 경험
베어 메탈 Home Assistant OS 아니요, 같은 디스크에 설치한 경우 예 전용 Home Assistant 장치

옵션 1: ZimaOS의 Home Assistant Container

ZimaOS에서 Docker를 통해 Home Assistant를 설치하면 Home Assistant Container를 실행하게 됩니다. 컨테이너에서 Home Assistant Core를 제공하며, 공식적으로 지원되는 Home Assistant 설치 유형입니다.

현재 Home Assistant 문서에는 다음과 같이 명시되어 있습니다.

  • Home Assistant Container는 Docker 또는 다른 OCI 호환 런타임에서 실행됩니다.
  • Home Assistant Supervisor가 포함되지 않습니다.
  • Home Assistant 앱/애드온을 제공하지 않습니다.
  • 지원 서비스와 업데이트는 직접 관리해야 합니다.

현재 참고 자료: Home Assistant Generic x86-64 설치 가이드.

“애드온 없음”은 MQTT, ESPHome 또는 기타 서비스를 실행할 수 없다는 뜻이 아닙니다

많은 Home Assistant 애드온은 일반 Docker 컨테이너로도 제공되는 소프트웨어를 래핑한 것입니다. ZimaOS에서 Home Assistant Container를 사용하면 MQTT 브로커, ESPHome, Node-RED 또는 데이터베이스 같은 서비스를 별도의 컨테이너로 실행할 수 있는 경우가 많습니다.

차이는 관리 방식입니다. Home Assistant Supervisor는 해당 컨테이너를 Home Assistant 애드온으로 설치, 업데이트, 모니터링, 백업하거나 통합하지 않습니다. 컨테이너의 Docker 수명 주기를 직접 관리해야 합니다.

옵션 2: ZVM에서 Home Assistant OS를 VM으로 실행

소스 스레드의 이후 답변에서 ZimaOS에 특화된 가장 유용한 설명을 제공했습니다. 커뮤니티 회원 ZimaRat은 Home Assistant 가상 머신 이미지를 다운로드해 ZimaOS에 복사하고, ZVM을 연 다음 사용자 지정 설치를 선택한 뒤 ZimaOS 파일에서 이미지를 선택하고 Home Assistant OS를 VM으로 부팅했다고 설명했습니다.

사용자는 HAOS가 초기화된 후 HACS와 애드온을 설치할 수 있었다고 보고했습니다. 또 다른 숙련된 커뮤니티 회원도 ZimaOS를 유지하면서 완전한 HAOS 환경을 사용할 수 있는 유효한 방법이라고 동의했습니다.

VM 방식으로 완전한 Home Assistant 환경을 제공하는 이유

Home Assistant OS는 완전한 어플라이언스 운영 체제입니다. 하드웨어 가상 머신 내부에서 실행되더라도 자체 가상 디스크와 Home Assistant Supervisor 환경을 계속 관리합니다.

이는 ZimaOS 내부에서 Home Assistant 애플리케이션만 Docker 컨테이너로 실행하는 것과는 근본적으로 다릅니다.

현재 Home Assistant 문서는 지원되는 하이퍼바이저에서 HAOS를 가상 머신으로 실행하는 기능을 공식 지원하며 다음과 같은 이미지를 제공합니다.

  • VirtualBox .vdi;
  • KVM/Proxmox .qcow2;
  • VMware .ova.

공식 참고 자료: Home Assistant OS 가상 머신 설치 가이드.

소스 작성자는 ZVM에서 VirtualBox 이미지를 사용했습니다

커뮤니티 답변에서는 Home Assistant의 대체 설치 페이지에 있는 VirtualBox 이미지를 사용해 압축을 풀고 ZimaOS에 복사한 다음 ZVM에서 선택했다고 구체적으로 설명했습니다.

이는 해당 커뮤니티 사용자가 2026년 ZVM 버전에서 확인한 결과입니다. 이를 향후 모든 ZVM 빌드가 모든 Home Assistant 이미지 형식을 변경 없이 지원한다는 의미로 일반화해서는 안 됩니다. 새 VM을 만들 때는 현재 사용 중인 ZVM 인터페이스에서 허용하는 이미지 형식을 사용하세요.

VM 리소스 요구 사항

Home Assistant의 현재 VM 가이드에는 다음 최소 사양이 나와 있습니다.

RAM 2GB
vCPU 2개

더 무거운 애드온, 음성 처리, 데이터베이스, 카메라 또는 대규모 자동화 워크로드를 사용할 계획이라면 리소스를 더 할당하세요.

모든 호스트 리소스를 HAOS VM에 할당하지 말고 ZimaOS와 다른 애플리케이션에 사용할 CPU와 메모리를 충분히 남겨 두세요.

Zigbee, Z-Wave 및 USB 라디오는 패스스루 필요

소스 답변은 ZVM에서 HAOS를 사용할 때의 한 가지 트레이드오프를 정확히 지적했습니다. Zigbee 또는 Z-Wave 코디네이터와 같은 물리적 USB 장치는 VM에 패스스루해야 합니다.

HAOS 내부에서 해당 무선 장치가 표시되지 않으면, ZimaOS가 호스트에서 USB 장치를 감지하더라도 Home Assistant는 이를 사용할 수 없습니다.

VM 설계를 진행하기 전에 현재 ZVM 릴리스가 자동화 하드웨어에 필요한 USB 패스스루를 지원하는지 확인하세요.

옵션 3: ZimaOS를 Home Assistant OS로 교체

미니 PC를 Home Assistant 전용으로 사용할 경우, 하드웨어에 HAOS를 직접 설치하는 것이 가장 간단한 완전한 Home Assistant 환경을 제공합니다.

그러나 원본 스레드에서는 처음에 설치 과정을 “USB에 HAOS를 플래시한 후 설치”라고 지나치게 단순화했습니다. 이후 한 사용자가 HAOS에는 USB에서 부팅해 내부 디스크에 자체적으로 기록하는 기존 방식의 설치 프로그램이 없다고 정확히 지적했습니다.

현재 Home Assistant 문서에는 다음과 같이 명시되어 있습니다.

HAOS에는 이미지를 자동으로 기록하는 통합 설치 프로그램이 없습니다.

일반적인 x86-64 하드웨어에서는 라이브 Ubuntu USB로 부팅한 후 디스크 유틸리티를 사용해 HAOS 디스크 이미지를 대상 내부 디스크에 복원하는 방법이 권장됩니다. 다른 방법으로는 다른 컴퓨터에서 HAOS 디스크 이미지를 대상 부팅 매체에 직접 기록할 수 있습니다.

ZimaOS 디스크에 HAOS를 설치하면 ZimaOS가 삭제됨

Home Assistant OS 자체가 운영 체제입니다. 현재 Windows 또는 ZimaOS가 들어 있는 물리 드라이브에 HAOS 이미지를 기록하면 해당 드라이브의 기존 운영 체제와 데이터가 덮어써집니다.

먼저 데이터를 백업하세요. “Home Assistant 앱 설치”와 “Home Assistant OS 설치”는 완전히 다른 작업입니다.

두 OS를 별도의 물리 디스크에 함께 유지할 수 있나요?

커뮤니티 답변에서는 ZimaOS에는 한 디스크를, Home Assistant OS에는 다른 디스크를 사용한 다음 펌웨어에서 부팅 장치를 선택하는 방법도 언급했습니다. 이렇게 하면 다른 OS를 덮어쓰지 않지만, 두 환경이 동시에 활성 상태인 것과는 다릅니다.

한 시스템에서 ZimaOS와 완전한 Home Assistant를 동시에 실행하려면 HAOS-in-ZVM 방식이 더 실용적입니다.

베어메탈 HAOS는 하드웨어/펌웨어 호환성 차이가 있을 수 있음

이후 한 참가자는 ZimaBoard용 외장 NVMe에 HAOS를 기록했지만, 동일한 NVMe가 다른 시스템에서는 부팅되었음에도 해당 하드웨어에서는 커널 오프셋/부팅 오류가 발생했다고 보고했습니다.

해당 스레드에서는 확인된 보편적 해결책이 제시되지 않았습니다. 따라서 모든 x86 Zima 장치에서 베어메탈 HAOS가 보장된다고 설명해서는 안 된다는 점을 다시 보여 줍니다. UEFI, 보안 부팅, 스토리지 컨트롤러 및 펌웨어 동작이 영향을 미칩니다.

현재 Generic x86-64 HAOS 요구 사항

현재 Home Assistant 가이드에는 다음이 필요합니다:

  • 64비트 Intel/AMD 시스템;
  • UEFI 부팅 모드;
  • Secure Boot 비활성화;
  • 전용 부팅 디스크 또는 부팅 미디어;
  • 초기 설정을 위한 네트워크/인터넷 액세스.

HAOS가 시작되면 Home Assistant는 일반적으로 다음 주소에서 사용할 수 있습니다:

http://homeassistant.local:8123

또는 VM/장치 IP 주소의 다음 포트를 통해 8123.

어떤 방법을 선택해야 하나요?

다음과 같은 경우 ZimaOS에서 Home Assistant Container를 선택하세요:

  • Docker를 편하게 관리하고 있다면;
  • Supervisor가 관리하는 애드온이 필요하지 않다면;
  • VM 오버헤드를 최소화하면서 일반적인 ZimaOS 앱을 여러 개와 함께 Home Assistant를 실행하고 싶다면.

다음과 같은 경우 ZVM에서 Home Assistant OS를 선택하세요:

  • Supervisor와 Home Assistant 애드온/앱 생태계를 사용하고 싶다면;
  • 같은 컴퓨터에서 ZimaOS를 계속 실행하고 싶다면;
  • VM 리소스를 할당하고 USB 장치를 패스스루하는 데 익숙하다면.

다음과 같은 경우 베어 메탈 Home Assistant OS를 선택하세요:

  • 컴퓨터를 Home Assistant 전용으로 사용할 경우;
  • 해당 컴퓨터에서 ZimaOS가 필요하지 않다면;
  • 가장 간단하고 공식적으로 권장되는 Home Assistant 어플라이언스 모델을 원한다면.

ZimaOS에서 완전한 Home Assistant 사용 체크리스트

  1. Supervisor/애드온이 실제로 필요한지 결정하세요.
  2. 그렇지 않다면 ZimaOS의 Home Assistant Container만으로 충분할 수 있습니다.
  3. 그렇고 ZimaOS를 유지하려면 ZVM에서 HAOS VM을 생성하세요.
  4. VM 워크플로에서 지원되는 최신 Home Assistant OS VM 이미지를 사용하세요.
  5. RAM은 최소 2GB, vCPU는 2개 이상 할당하고, 작업 부하가 더 큰 경우에는 추가로 할당하세요.
  6. Home Assistant에서 Zigbee/Z-Wave/USB 장치가 필요하다면 해당 장치를 패스스루하세요.
  7. VM 내부에서 HAOS 자체 백업 기능을 사용하세요.
  8. HAOS를 베어 메탈에 설치하는 경우, 이미지를 기록하면 대상 디스크의 OS가 교체된다는 점을 이해해야 합니다.

ZimaOS에서 완전한 Home Assistant 사용 FAQ

어떤 ZimaOS 버전에서 Home Assistant 애드온이 활성화되나요?

특정 ZimaOS 버전이 애드온을 활성화하는 것은 아닙니다. 애드온 사용 가능 여부는 Home Assistant Container가 아니라 Home Assistant OS/Supervisor를 실행하는지에 따라 달라집니다.

ZimaOS의 Home Assistant Docker 앱에서 애드온을 설치할 수 있나요?

아니요. 현재 Home Assistant 문서에 따르면 Container 설치 방식은 Home Assistant 앱/애드온에 액세스할 수 없습니다.

ZVM에서 완전한 Home Assistant를 실행할 수 있나요?

원본 스레드에는 HACS와 애드온을 포함한, 사용자가 확인한 ZVM 내 HAOS 설정 사례가 있습니다. 이를 커뮤니티에서 확인된 ZimaOS 워크플로로 간주하되, 현재 ZVM 이미지와 USB 패스스루 지원 여부를 확인하세요.

Home Assistant OS를 설치하면 ZimaOS가 삭제되나요?

현재 ZimaOS가 들어 있는 동일한 물리 디스크에 HAOS를 기록하는 경우에는 그렇습니다. HAOS를 VM에서 실행하면 기존 OS를 교체하지 않아도 됩니다.