스마트홈에 관심을 가지기 시작하면서 자연스럽게 Home Assistant라는 이름을 접하게 됐다. 오픈소스 기반의 강력한 홈 자동화 플랫폼이라는 소개에 끌렸고, 마침 집에 굴러다니던 시놀로지 NAS가 있었기에 별도의 하드웨어 없이 Docker로 설치해보기로 결심했다. 결론부터 말하자면, 설치 자체는 성공했지만 그 과정과 이후 경험이 생각보다 순탄하지 않았다.
왜 NAS Docker에 설치하려 했는가
많은 Home Assistant 입문자들이 라즈베리파이를 먼저 떠올리지만, 나는 이미 24시간 켜져 있는 NAS를 활용하고 싶었다. 추가 전력 소모 없이, 별도 기기 구매 없이 그냥 Docker 컨테이너 하나만 올리면 되지 않을까 하는 생각이었다. 시놀로지 NAS의 Container Manager(구 Docker 패키지)를 통해 설치하는 방식은 인터넷에 자료도 많고, 진입 장벽도 낮아 보였다.
실제로 초기 설치는 어렵지 않았다. Docker Hub에서 homeassistant/home-assistant 이미지를 받아오고, 포트 포워딩과 볼륨 마운트를 설정한 후 컨테이너를 실행하면 웹 UI가 뜨는 방식이다. 처음 부팅 후 온보딩 화면이 나타났을 때는 꽤 설레기도 했다.
설치 직후 만난 첫 번째 벽: 통합 구성 요소 제한
문제는 실제로 기기들을 연동하려는 순간부터 시작됐다. Home Assistant에는 수백 가지의 통합(Integration) 기능이 있는데, 그 중 상당수가 Bluetooth, USB 동글, 직접적인 하드웨어 접근을 필요로 한다. NAS Docker 환경에서는 이런 하드웨어 접근이 극히 제한적이다.
예를 들어 Matter나 Zigbee 기기를 연결하려면 별도의 USB 코디네이터 장치가 필요한데, NAS에 USB 장치를 붙이더라도 Docker 컨테이너 안에서 해당 장치를 정상적으로 인식시키는 과정이 단순하지 않았다. 시놀로지 DSM의 권한 구조 때문에 장치 패스스루(device passthrough)가 원활하지 않은 경우가 많고, 커뮤니티에서도 이 부분에서 막히는 사람들이 꽤 있었다.
HACS와 애드온(Add-on)을 쓸 수 없다는 치명적인 단점
Home Assistant를 쓰는 이유 중 하나가 방대한 커뮤니티 생태계다. 그런데 NAS Docker 방식은 Home Assistant OS(HAOS) 또는 Supervised 방식이 아니기 때문에, 공식 Add-on Store를 사용할 수 없다. 즉, Node-RED, Mosquitto MQTT 브로커, ESPHome, Z-Wave JS 같은 인기 애드온들을 클릭 한 번으로 설치하는 것이 불가능하다.
물론 이 기능들을 별도의 Docker 컨테이너로 따로따로 구성할 수는 있다. 하지만 그 과정에서 docker-compose.yml을 직접 짜고, 네트워크를 구성하고, 각 서비스 간 연동을 수동으로 설정해야 한다. 처음에 “편하게 하려고” 시작했던 것이 어느 순간 더 복잡한 작업의 연속이 되어버렸다.
마찬가지로 HACS(Home Assistant Community Store)도 설치 자체는 가능하지만, 일부 커스텀 컴포넌트들이 Supervised 환경을 전제로 만들어져 있어 동작 불안정 문제가 생기기도 했다.
업데이트와 유지관리의 번거로움
Home Assistant는 업데이트가 매우 활발한 프로젝트다. 거의 매달 새로운 버전이 나오고, 보안 패치나 기능 개선이 잦다. HAOS 환경에서는 웹 UI에서 클릭 한 번으로 업데이트가 완료되지만, Docker 방식에서는 직접 이미지를 pull하고 컨테이너를 재생성해야 한다.
시놀로지 Container Manager에서 이미지 업데이트를 진행하다가 설정 파일이 꼬이는 경험도 했고, 특정 버전에서 볼륨 마운트 경로 문제로 대시보드 설정이 날아갈 뻔한 적도 있었다. 매번 업데이트 전에 백업을 챙겨야 한다는 부담이 생각보다 컸다.
NAS Docker vs 다른 설치 방식 비교
| 설치 방식 | 애드온 지원 | 하드웨어 접근 | 업데이트 편의성 | 추천 대상 |
|---|---|---|---|---|
| HAOS (전용 기기) | ✅ 전체 지원 | ✅ 완전 지원 | ✅ 원클릭 | 모든 사용자 |
| Supervised (데비안) | ✅ 전체 지원 | ✅ 지원 | 🔶 보통 | 중급 사용자 |
| Container (Docker) | ❌ 불가 | 🔶 제한적 | 🔶 수동 | 고급 사용자 |
| NAS Docker (본 후기) | ❌ 불가 | ❌ 매우 제한 | ❌ 번거로움 |
함께 보면 좋은 글