2024년 원본 포럼 게시물은 주로 BigBear 튜토리얼을 안내하는 글이므로, 완전히 고정된 설치 방법으로 간주해서는 안 됩니다. 다행히 현재도 BigBearCasaOS는 Home Assistant의 공식 컨테이너 이미지를 사용하는 Home Assistant 패키지를 유지 관리하고 있습니다. 중요한 아키텍처 결정은 단순히 “실행할 수 있는가?”가 아니라 어떤 Home Assistant 설치 유형을 원하는가입니다.
Home Assistant Container는 CasaOS/Docker에서 잘 실행되며 일반적인 Home Assistant Core UI와 통합 기능을 제공합니다. 그러나 현재 공식 문서에는 Container에 Home Assistant Supervisor나 Home Assistant OS에서 제공하는 앱/애드온 생태계가 포함되지 않는다고 명시되어 있습니다. 전체 HAOS/Supervisor 환경이 필요하다면 지원되는 하드웨어에서 Home Assistant OS를 실행하거나 대신 VM을 사용하세요.
BigBearCasaOS는 여전히 Home Assistant를 유지 관리합니다
현재 BigBearCasaOS 카탈로그에는 ghcr.io/home-assistant/home-assistant가 등록되어 있으며, 지원되는 플랫폼 전반에서 앱 패키지를 계속 동기화하고 있습니다.
현재 BigBearCasaOS 카탈로그를 사용하세요.
/config 디렉터리를 영구 저장소로 유지하세요
Home Assistant의 구성, 데이터베이스 및 통합 설정은 컨테이너 모델에서 /config 아래에 저장됩니다. 이 폴더를 CasaOS의 영구 저장소에 매핑하고, 주요 업그레이드 전에 백업하세요.
/config가 그대로 유지되면 컨테이너를 다시 만들어도 Home Assistant 인스턴스가 삭제되지 않아야 합니다.
Home Assistant는 일반적으로 호스트 네트워킹을 사용합니다
현재 Home Assistant Container 지침에서는 --network=host 사용을 권장합니다. 이를 통해 로컬 검색 프로토콜이 원활하게 작동하고 각 서비스 포트를 수동으로 게시할 필요가 줄어듭니다.
호스트 네트워킹을 사용하면 컨테이너가 호스트의 네트워크 네임스페이스를 공유하므로 포트 충돌과 방화벽 노출을 주의 깊게 검토해야 합니다.
Bluetooth에는 추가적인 호스트 접근 권한이 필요합니다
현재 공식 지침에 따르면 문서화된 Docker 설정에서 D-Bus 마운트는 선택 사항이지만 Bluetooth 통합 기능을 사용하려면 필요합니다. USB Zigbee/Z-Wave 라디오에도 명시적인 장치 매핑이 필요할 수 있습니다.
CasaOS에서 USB 장치를 인식한다고 해서 해당 USB 라디오가 Home Assistant에 자동으로 표시된다고 가정하지 마세요.
Container에는 Supervisor 앱/애드온이 없습니다
이는 Home Assistant OS와 가장 크게 다른 점입니다. 현재 Home Assistant 문서에는 Container 설치에서는 앱/애드온에 접근할 수 없으며, 완전한 관리형 생태계를 원하는 대부분의 사용자에게 HAOS를 권장한다고 명시되어 있습니다.
현재 Home Assistant Container 문서를 확인하세요.
완전한 관리형 환경을 원한다면 VM에서 Home Assistant OS를 사용하세요
CasaOS 호스트에 충분한 CPU/RAM과 가상화 지원이 있다면 VM에서 HAOS를 실행할 수 있습니다. 이렇게 하면 Home Assistant가 자체 OS, Supervisor 및 애드온을 사용하면서도 CasaOS는 다른 서비스의 호스트로 유지할 수 있습니다.
VM에서 Zigbee/Z-Wave 하드웨어를 사용해야 한다면 USB 라디오 패스스루를 별도로 계획하세요.
Home Assistant 원격 액세스는 신중하게 설정하세요
Home Assistant는 카메라, 잠금 장치, 센서 및 자동화 상태를 제어합니다. 신중한 원격 액세스 및 인증 설계 없이 포트 8123을 인터넷에 직접 공개하지 마세요. 공식 Home Assistant Cloud 옵션, VPN/오버레이 네트워크 또는 보안이 강화된 인증형 리버스 프록시를 사용하는 것이 좋습니다.
업데이트 전에 Home Assistant를 백업하세요
Container 설치에서는 영구 저장되는 /config 디렉터리와 인스턴스에서 사용하는 외부 데이터베이스를 보호하세요. 홈 자동화 상태를 NAS에 저장한 유일한 사본에 의존하기 전에 복원을 테스트하세요.
CasaOS에서 Home Assistant 사용하기 FAQ
BigBearCasaOS는 여전히 Home Assistant 패키지를 제공하나요?
예. 현재 BigBear 카탈로그에는 여전히 공식 Home Assistant 컨테이너 이미지가 등록되어 있습니다.
Home Assistant Container에 Supervisor 애드온이 포함되나요?
아니요. 현재 Home Assistant 문서에는 Container 설치에 앱/애드온이 포함되지 않는다고 명시되어 있습니다.
전체 HAOS 환경을 사용하려면 어떻게 해야 하나요?
지원되는 하드웨어에서 Home Assistant OS를 사용하거나 VM에서 실행하세요. 필요한 USB 라디오가 있다면 패스스루를 구성해야 합니다.
