[Home Assistant] Synology Nas + Docker + Home Assistant Supervisor 설치방법

시놀로지 Nas에서 Home Assistant를 설치할 수 있는 방법은 많이 있습니다. 다만, VMM(가상머신)을 이용한 설치가 아니라면, HAOS 또는 HA Supervisor 설치를 할수가 없었습니다. 왜 HAOS 또는 HA Supervisor를 설치하려는가에 대해서는 이미 아시는 분들이 많을것입니다. 애드온 기능의 사용 가능 여부 입니다.

사실 애드온을 안써보신 분이라면, 그게 꼭 필요할지 의구심을 가질수 있겠지만, 한번 사용해보신 분들은… 이게 한번만 사용하진 않을것 같습니다. (이미 단맛을 보셨기에…)

그런데, 시놀로지 Docker에서도 이 Supervisor를 설치/사용할 수 있는 방법이 있어 포스팅하려고 합니다.

Container Manager 설치

Container Manager 를 설치합니다. DSM7.2 버전에서 부터 사용이 가능하므로, DSM7.1 버전이라면, Docker 유틸을 사용하시면 됩니다.

홈어시스턴트를 설치 경로 지정

홈어시스턴트를 설치할 Docker 밑의 경로를 지정합니다. /volume1/docker/ 디렉토리 밑으로 ‘homeassistant’ 폴더를 생성합니다. 디렉토리는 소문자로만 구성되어야 합니다.

작업 스케줄러를 이용하여 docker script를 실행

Synology의 제어판에는 작업 스케줄러라는 메뉴가 있는데, UNIX 명령 기반의 스크립트를 등록해놓으면 정해진 스케줄에 따라 명령을 수행하는 기능이 있습니다. 물론 ssh를 이용해서 CMD로 명령을 해도 괜찮겠지만, 난위도를 줄이고 에러가 발생하더라도 로그를 남기기 위해서는 이 방식을 권장합니다.

만약 설치 경로로 생성한 폴더를 다르게 하시려면 아래 소스 중에서 볼드체로 표시된 부분을 생성한 폴더명으로 맞춰주시면 됩니다.

설치할 버전은 아래 2025.02.1 버전에서 설치 완료를 확인했으나, 이후 최신 버전에 대해서는 아래 링크를 방문하여, 최신 릴리즈 버전을 찾아보시길 권장합니다.

https://github.com/home-assistant/supervisor

docker run -d --name=hassio_supervisor \ 
-v /var/run/docker.sock:/var/run/docker.sock \ 
-v /var/run/dbus:/var/run/dbus \ 
-v /volume1/docker/homeassistant:/data \ 
-e SUPERVISOR_SHARE=/volume1/docker/homeassistant \ 
-e SUPERVISOR_NAME=hassio_supervisor \ 
-e HOMEASSISTANT_REPOSITORY=homeassistant/qemux86-64-homeassistant \ 
--security-opt seccomp=unconfined \ 
--privileged \ 
--restart always \ 
ghcr.io/home-assistant/amd64-hassio-supervisor:2025.02.1 
mount --make-shared /volume1/

설치 진행

스크립트가 실행되면서 Docker에서 필요한 컨테이너들을 계속 추가됩니다.

접속

설치가 완료되면, http://homeassistant-path:8123 으로 접속해봅니다.

Home Assistant Supervisor가 설치 완료되었습니다.