라즈베리파이 HomeAssistant 설치

1. smarthome 폴더로 이동

터미널에서 smarthome 작업 디렉토리로 이동합니다.

Bash

 

cd ~/smarthome

---

2. Home Assistant 데이터 저장 폴더 생성

Home Assistant의 설정 및 데이터를 보관할 폴더를 만듭니다.

Bash

 

mkdir -p homeassistant

---

3. docker-compose.yml 파일 수정

기존 작성했던 docker-compose.yml 파일을 열어 Home Assistant 설정을 함께 구성합니다.

Bash

 

nano docker-compose.yml

파일 내용을 아래와 같이 수정/작성합니다:

YAML

 

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /home/hak/smarthome/ha_config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host


  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - N8N_SECURE_COOKIE=false
      - NODE_ENV=production
      - GENERIC_TIMEZONE=Asia/Seoul
    volumes:
      - /home/hak/smarthome/n8n_data:/home/node/.n8n

참고 (network_mode: host): Home Assistant는 네트워크 상의 스마트 기기(지그비, 스마트 스위치, 조명 등)를 자동으로 탐지(mDNS/SSDP)해야 하므로 Docker 기본 포트 포워딩 대신 **network_mode: host**를 사용하는 것이 공식 권장사항입니다.

---

4. 컨테이너 실행 및 확인

설정 저장을 완료한 후 아래 명령어로 실행합니다.

Bash

 

docker compose up -d

---

5. 접속 확인

Home Assistant 기본 포트는 8123입니다.

1. 웹 브라우저를 열고 접속합니다:
   • http://192.168.45.2:8123 또는 http://localhost:8123
2. 처음 접속 시 계정 생성 및 초기 위치/시간대 설정 화면이 나타납니다. 안내에 따라 입력을 완료하면 홈 어시스턴트 대시보드로 이동합니다.

 

Home Assistant에 zigbee 동글 연결해서 집 조명스위치 제어 예정.