Home Assistant 사용자 가이드
Home Assistant란?
Home Assistant(HA)는 무인 공간의 모든 스마트 기기를 하나로 통합 관리할 수 있는 오픈소스 홈 자동화 플랫폼입니다. 조명, 온도, 보안 시스템, 센서 등을 한 곳에서 제어하고 자동화할 수 있습니다.
주요 특징
- ✅ 무료 오픈소스: 비용 없이 모든 기능 사용
- ✅ 로컬 제어: 인터넷 없이도 작동
- ✅ 2000+ 통합: 다양한 브랜드 기기 지원
- ✅ 자동화: 시간, 상태, 이벤트 기반 자동 실행
- ✅ 모바일 앱: 어디서나 원격 제어
1. 시작하기
Home Assistant 접속하기
웹브라우저 열기
- 크롬, 엣지, 사파리 등 최신 브라우저 사용
주소 입력
http://homeassistant.local:8123 또는 http://[설치된IP주소]:8123 예: http://192.168.1.100:8123로그인
┌─────────────────────────────┐ │ Home Assistant │ │ │ │ 사용자이름: [_________] │ │ 비밀번호: [_________] │ │ │ │ [로그인] │ └─────────────────────────────┘
첫 화면 둘러보기
로그인 후 보이는 대시보드:
┌────────────────────────────────────────┐
│ 🏠 개요 📊 에너지 📋 로그북 ⚙️ 설정 │
├────────────────────────────────────────┤
│ │
│ 무인 공간 현황 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 거실 │ │ 사무실 │ │ 창고 │ │
│ │ 💡 ON │ │ 💡 OFF │ │ 💡 ON │ │
│ │ 23°C │ │ 22°C │ │ 20°C │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ 최근 활동 │
│ • 10:30 - 정문 열림 │
│ • 10:15 - 사무실 조명 꺼짐 │
│ • 09:00 - 난방 시작 │
│ │
└────────────────────────────────────────┘2. 대시보드 이해하기
기본 카드 종류
Home Assistant의 화면은 '카드'로 구성됩니다. 각 카드는 다른 정보나 제어 기능을 제공합니다.
전등 카드
┌──────────────────┐
│ 💡 거실 조명 │
│ │
│ [━━━━○━━━] 70% │
│ │
│ ON/OFF [🔘] │
└──────────────────┘- 슬라이더로 밝기 조절
- 토글 버튼으로 켜기/끄기
온도 카드
┌──────────────────┐
│ 🌡️ 실내 온도 │
│ │
│ 23.5°C │
│ 습도: 45% │
│ │
└──────────────────┘센서 카드
┌──────────────────┐
│ 🚪 정문 │
│ │
│ [닫힘] │
│ │
│ 마지막: 10분 전 │
└──────────────────┘대시보드 보기 모드
상단 메뉴에서 선택 가능한 보기:
| 보기 모드 | 설명 | 용도 |
|---|---|---|
| 개요 | 모든 장치 한눈에 보기 | 전체 상태 확인 |
| 방별 | 공간별로 그룹화 | 특정 구역 관리 |
| 에너지 | 전력 사용량 모니터링 | 에너지 절약 |
| 로그북 | 모든 활동 기록 | 문제 추적 |
| 미디어 | 음악/비디오 제어 | 멀티미디어 관리 |
3. 장치 추가하기
자동 검색된 장치 추가
설정 메뉴 진입
⚙️ 설정 → 기기 및 서비스발견된 장치 확인
┌────────────────────────────────┐ │ 발견된 장치 │ │ │ │ • Philips Hue Bridge │ │ [설정하기] │ │ │ │ • 샤오미 공기청정기 │ │ [설정하기] │ │ │ │ • LG 스마트 TV │ │ [설정하기] │ └────────────────────────────────┘장치 설정
- [설정하기] 클릭
- 안내에 따라 진행
- 대부분 자동으로 완료
수동으로 장치 추가
통합 추가
설정 → 기기 및 서비스 → [+ 통합 추가]브랜드/종류 검색
┌────────────────────────────────┐ │ 통합 검색 │ │ │ │ 🔍 [샤오미_______] │ │ │ │ 검색 결과: │ │ • Xiaomi Miio │ │ • Xiaomi Aqara │ │ • Xiaomi BLE │ └────────────────────────────────┘연결 정보 입력
┌────────────────────────────────┐ │ Xiaomi 장치 추가 │ │ │ │ IP 주소: [192.168.1.___] │ │ 토큰: [________________] │ │ │ │ ℹ️ 토큰 찾는 방법 보기 │ │ │ │ [제출] [취소] │ └────────────────────────────────┘
인기 스마트 기기 연동 가이드
스마트 전구 (Philips Hue, Yeelight 등)
- 전구를 전원에 연결
- 제조사 앱으로 초기 설정
- Home Assistant에서 자동 검색
- [설정하기] 클릭으로 추가
스마트 플러그
- 플러그를 콘센트에 연결
- 제조사 앱으로 Wi-Fi 연결
- Home Assistant 통합 추가
- IP 주소 입력 (보통 자동 검색)
온습도 센서
- 센서 전원 켜기
- Zigbee 허브가 있다면 자동 페어링
- 없다면 Wi-Fi 버전 사용 권장
4. 방(구역) 설정하기
새로운 방 만들기
영역 관리 열기
설정 → 영역 및 구역 → [+ 영역 만들기]방 정보 입력
┌────────────────────────────────┐ │ 새 영역 만들기 │ │ │ │ 이름: [1층 로비_____] │ │ │ │ 아이콘: 🏠 ▼ │ │ │ │ 층: [1층 ▼] │ │ │ │ [만들기] [취소] │ └────────────────────────────────┘
장치를 방에 할당하기
장치 선택
설정 → 기기 및 서비스 → 장치 선택영역 지정
┌────────────────────────────────┐ │ 거실 조명 설정 │ │ │ │ 영역: [거실 ▼] │ │ • 거실 │ │ • 사무실 │ │ • 창고 │ │ • 화장실 │ │ │ │ [업데이트] │ └────────────────────────────────┘
5. 자동화 만들기
자동화는 "조건이 만족되면 자동으로 동작을 실행"하는 규칙입니다.
간단한 자동화 예제
예제 1: 출입 시 조명 자동 켜기
자동화 메뉴 진입
설정 → 자동화 및 장면 → [+ 자동화 만들기]자동화 이름 설정
이름: "출입문 열면 조명 켜기"트리거(언제) 설정
┌────────────────────────────────┐ │ 트리거 추가 │ │ │ │ 유형: [장치 ▼] │ │ 장치: [정문 센서 ▼] │ │ 트리거: [열림으로 변경 ▼] │ │ │ │ [추가] │ └────────────────────────────────┘동작(무엇을) 설정
┌────────────────────────────────┐ │ 동작 추가 │ │ │ │ 유형: [장치 ▼] │ │ 장치: [로비 조명 ▼] │ │ 동작: [켜기 ▼] │ │ │ │ [추가] │ └────────────────────────────────┘저장
[💾 저장] 버튼 클릭
실용적인 자동화 예제
예제 2: 시간대별 조명 밝기 조절
자동화 이름: "시간대별 조명 자동 조절"
트리거(언제):
- 시간: 매일 아래 시간에
조건(추가 조건):
- 평일만 실행
동작(무엇을):
06:00 → 조명 30% 밝기
09:00 → 조명 100% 밝기
18:00 → 조명 70% 밝기
22:00 → 조명 끄기예제 3: 온도 기반 에어컨 제어
자동화 이름: "실내 온도 자동 조절"
트리거(언제):
- 온도 센서 > 28°C
조건(추가 조건):
- 시간: 09:00 - 22:00 사이
- 창문: 모두 닫힘
동작(무엇을):
- 에어컨 켜기
- 목표 온도 24°C 설정
- 1시간 후 자동 꺼짐예제 4: 퇴근 모드
자동화 이름: "퇴근 시 전체 끄기"
트리거(언제):
- 시간: 평일 18:00
또는
- 버튼: 퇴근 버튼 누름
동작(무엇을):
- 모든 조명 끄기
- 에어컨/난방 끄기
- 보안 시스템 활성화
- 알림: "퇴근 모드 실행됨"조건 설정하기
자동화에 조건을 추가하면 더 똑똑하게 작동합니다.
┌────────────────────────────────┐
│ 조건 유형 │
│ │
│ • 시간 조건 │
│ ○ 특정 시간대 │
│ ○ 일출/일몰 전후 │
│ │
│ • 상태 조건 │
│ ○ 장치 상태 (켜짐/꺼짐) │
│ ○ 센서 값 (온도, 습도 등) │
│ │
│ • 요일 조건 │
│ ○ 평일/주말 │
│ ○ 특정 요일 │
└────────────────────────────────┘6. 대시보드 꾸미기
새 대시보드 만들기
대시보드 편집 모드
상단 메뉴 → ⋮ (점 3개) → 대시보드 편집새 탭 추가
[+ 탭 추가] → 이름 입력 (예: "1층", "보안", "에너지")
카드 추가하기
카드 추가 버튼
[+ 카드 추가] 클릭카드 종류 선택
┌────────────────────────────────┐ │ 카드 선택 │ │ │ │ 인기 카드: │ │ • 버튼 - 단순 켜기/끄기 │ │ • 게이지 - 원형 표시기 │ │ • 그래프 - 시간별 변화 │ │ • 엔티티 - 상태 표시 │ │ • 날씨 - 날씨 정보 │ │ • 미디어 - 음악/비디오 │ └────────────────────────────────┘
실용적인 대시보드 레이아웃
무인 매장 대시보드
┌─────────────────────────────────────┐
│ 🏪 무인 매장 관리 │
├─────────────────────────────────────┤
│ │
│ 출입 현황 조명 제어 │
│ ┌─────────┐ ┌─────────┐ │
│ │ 🚪 │ │ 💡 전체 │ │
│ │ 3명 │ │ [ON/OFF] │ │
│ │ 입장 중 │ │ 자동모드 │ │
│ └─────────┘ └─────────┘ │
│ │
│ 온도/습도 전력 사용 │
│ ┌─────────┐ ┌─────────┐ │
│ │ 23°C │ │ ⚡ 2.5kW │ │
│ │ 45% │ │ 📊 그래프 │ │
│ └─────────┘ └─────────┘ │
│ │
│ 보안 카메라 긴급 버튼 │
│ ┌─────────┐ ┌─────────┐ │
│ │ 📹 정상 │ │ 🚨 비상 │ │
│ │ 녹화 중 │ │ [호출] │ │
│ └─────────┘ └─────────┘ │
│ │
└─────────────────────────────────────┘에너지 모니터링 대시보드
┌─────────────────────────────────────┐
│ ⚡ 에너지 관리 │
├─────────────────────────────────────┤
│ │
│ 실시간 사용량 │
│ ┌─────────────────────────┐ │
│ │ 📊 2.5kW │ │
│ │ ████████░░░░ 75% │ │
│ └─────────────────────────┘ │
│ │
│ 구역별 사용량 │
│ • 조명: 0.5kW (20%) │
│ • 에어컨: 1.5kW (60%) │
│ • 기타: 0.5kW (20%) │
│ │
│ 오늘 사용량: 45.2kWh │
│ 예상 요금: ₩12,500 │
│ │
└─────────────────────────────────────┘카드 커스터마이징
버튼 카드 꾸미기
yaml
카드 설정:
이름: "전체 조명"
아이콘: 💡
색상:
켜짐: 노란색
꺼짐: 회색
탭 동작: 토글
길게 누르기: 상세 설정게이지 카드 설정
yaml
카드 설정:
이름: "실내 온도"
단위: °C
최소값: 10
최대값: 35
색상 구간:
- 10-18: 파란색 (추움)
- 18-26: 초록색 (적정)
- 26-35: 빨간색 (더움)7. 모바일 앱 사용하기
앱 설치 및 연결
앱 다운로드
- iOS: App Store에서 "Home Assistant" 검색
- Android: Play Store에서 "Home Assistant" 검색
서버 연결
┌────────────────────────────────┐ │ Home Assistant 연결 │ │ │ │ 서버 주소: │ │ [http://192.168.1.100:8123] │ │ │ │ 또는 QR 코드 스캔 │ │ [📷 스캔] │ │ │ │ [다음] │ └────────────────────────────────┘로그인
- 웹과 동일한 계정 사용
모바일 전용 기능
위치 기반 자동화
집 도착 → 현관 조명 켜기
집 출발 → 모든 전원 끄기알림 받기
┌────────────────────────────────┐
│ 📱 Home Assistant │
│ │
│ 🚪 정문이 열렸습니다 │
│ 2분 전 │
│ │
│ 🌡️ 실내 온도가 30°C를 │
│ 넘었습니다 │
│ 방금 │
└────────────────────────────────┘위젯 설정
홈 화면에 바로가기 추가:
- 조명 전체 켜기/끄기
- 온도 확인
- 보안 모드 전환
8. 무인 공간 활용 시나리오
시나리오 1: 무인 카페
영업 시작 자동화
yaml
자동화: "카페 오픈"
시간: 매일 07:00
동작:
1. 입구 조명 켜기
2. 실내 조명 50% 밝기
3. 배경음악 재생
4. 에어컨 24°C 설정
5. 커피머신 예열 시작
6. 디지털 메뉴판 켜기고객 감지 시스템
yaml
자동화: "고객 입장"
트리거: 입구 동작 감지
동작:
1. 환영 멜로디 재생
2. 조명 100%로 밝게
3. 주문 키오스크 활성화
4. 카운터 조명 켜기마감 자동화
yaml
자동화: "카페 마감"
시간: 매일 22:00
동작:
1. 5분 전 마감 안내 방송
2. 배경음악 페이드 아웃
3. 조명 단계적 어둡게
4. 모든 전원 차단
5. 보안 시스템 활성화시나리오 2: 무인 사무실
출근 시간대 설정
yaml
자동화: "업무 시작"
시간: 평일 08:30
동작:
1. 사무실 조명 켜기
2. 에어컨/난방 가동
3. 프린터 전원 켜기
4. 커피머신 준비
5. 배경음악 재생회의실 예약 연동
yaml
자동화: "회의실 준비"
트리거: 캘린더 이벤트 15분 전
동작:
1. 회의실 조명 켜기
2. 에어컨 가동
3. TV/프로젝터 준비
4. 회의 시작 알림에너지 절약 모드
yaml
자동화: "점심시간 절전"
시간: 12:00-13:00
조건: 사무실 비어있음
동작:
1. 불필요한 조명 끄기
2. 에어컨 절전 모드
3. 모니터 대기 모드시나리오 3: 무인 매장
재고 관리 알림
yaml
자동화: "재고 부족 알림"
트리거: 무게 센서 < 1kg
동작:
1. 관리자에게 알림 발송
2. 대시보드에 경고 표시
3. 자동 발주 시스템 연동이상 상황 감지
yaml
자동화: "비정상 감지"
트리거:
- 새벽 시간 동작 감지
- 비상벨 누름
- 온도 이상
동작:
1. 보안업체 자동 연락
2. 관리자 긴급 알림
3. CCTV 녹화 시작
4. 경고등 작동9. 에너지 관리
에너지 대시보드 설정
에너지 설정 진입
설정 → 대시보드 → 에너지전력 측정 장치 추가
┌────────────────────────────────┐ │ 전력 모니터링 설정 │ │ │ │ 전체 전력: │ │ [스마트 미터 선택 ▼] │ │ │ │ 개별 장치: │ │ □ 에어컨 (2.5kW) │ │ □ 조명 (0.5kW) │ │ □ 냉장고 (0.3kW) │ │ │ │ 요금 설정: │ │ 기본: ₩120/kWh │ │ 심야: ₩80/kWh │ └────────────────────────────────┘
전력 사용 패턴 분석
일일 사용 패턴:
kW
3 | ╱╲
2 | ╱ ╲____╱╲
1 |__╱ ╲__
0 └────────────────────
0 6 12 18 24 시
피크 시간: 09:00-11:00, 14:00-16:00절전 자동화
yaml
자동화: "피크 시간 절전"
트리거: 전력 사용 > 3kW
동작:
1. 비필수 장치 끄기
2. 에어컨 온도 1도 올리기
3. 조명 밝기 20% 감소
4. 알림: "절전 모드 활성화"10. 보안 기능
보안 대시보드
┌─────────────────────────────────────┐
│ 🔒 보안 상태 │
├─────────────────────────────────────┤
│ │
│ 경계 모드: [활성화] [비활성화] │
│ │
│ 센서 상태: │
│ • 정문: ✅ 닫힘 │
│ • 창문1: ✅ 닫힘 │
│ • 창문2: ⚠️ 열림 │
│ • 동작감지: ✅ 정상 │
│ │
│ 최근 이벤트: │
│ 15:30 - 정문 열림 (정상) │
│ 14:20 - 창문2 열림 │
│ │
└─────────────────────────────────────┘보안 자동화 설정
야간 경계 모드
yaml
자동화: "야간 보안"
시간: 22:00
동작:
1. 모든 문/창 상태 확인
2. 보안 카메라 녹화 시작
3. 동작 감지 민감도 높이기
4. 이상 감지 시 즉시 알림침입 감지
yaml
자동화: "침입 경보"
트리거:
- 야간 동작 감지
- 강제 개방 감지
동작:
1. 사이렌 작동
2. 모든 조명 점멸
3. 보안업체 자동 신고
4. 관리자 긴급 전화
5. CCTV 클라우드 백업11. 음성 제어
음성 비서 연동
Google Assistant 연동
- Google Home 앱 열기
- [+] → 기기 설정 → Home Assistant 검색
- 계정 연결
- 사용할 장치 선택
음성 명령 예시
"OK Google..."
• "거실 불 켜줘"
• "에어컨 24도로 설정해줘"
• "모든 불 꺼줘"
• "현재 온도 알려줘"
• "보안 모드 켜줘"사용자 정의 음성 명령
yaml
음성 명령: "퇴근 모드"
동작:
1. 모든 조명 끄기
2. 에어컨 끄기
3. 보안 시스템 활성화
4. "퇴근 모드가 실행되었습니다" 응답12. 백업 및 복구
백업 설정
백업 메뉴
설정 → 시스템 → 백업자동 백업 설정
┌────────────────────────────────┐ │ 백업 설정 │ │ │ │ 자동 백업: [활성화 🔘] │ │ │ │ 백업 주기: │ │ ○ 매일 │ │ ● 매주 │ │ ○ 매월 │ │ │ │ 백업 시간: [03:00] │ │ │ │ 보관 개수: [3개] │ └────────────────────────────────┘수동 백업
[지금 백업 만들기] 클릭 → 백업 이름 입력 → [만들기]
복구 방법
- 백업 파일 선택
- [복구] 버튼 클릭
- 시스템 재시작 대기
- 설정 확인
13. 문제 해결
자주 발생하는 문제
"장치가 응답하지 않음"
✅ 해결 방법:
- 장치 전원 확인
- Wi-Fi 연결 상태 확인
- 장치 재시작
- Home Assistant 재시작
"자동화가 작동하지 않음"
✅ 해결 방법:
- 자동화 활성화 상태 확인
- 조건 설정 검토
- 로그북에서 오류 확인
- 시간대 설정 확인
"대시보드가 느림"
✅ 해결 방법:
- 불필요한 카드 제거
- 브라우저 캐시 삭제
- 시스템 리소스 확인
- 데이터베이스 정리
로그 확인 방법
로그북 열기
좌측 메뉴 → 로그북필터링
┌────────────────────────────────┐ │ 로그 필터 │ │ │ │ 기간: [오늘 ▼] │ │ 장치: [전체 ▼] │ │ 유형: [전체 ▼] │ │ │ │ 🔍 검색: [________] │ └────────────────────────────────┘오류 찾기
- 빨간색 항목 확인
- 시간순 정렬
- 상세 정보 클릭
14. 고급 기능
스크립트 만들기
스크립트는 여러 동작을 하나로 묶은 것입니다.
yaml
스크립트: "아침 루틴"
순서:
1. 커튼 열기
2. 조명 30% 켜기
3. 5분 대기
4. 조명 70%로 올리기
5. 라디오 켜기
6. 커피머신 시작센서 템플릿
여러 센서 값을 조합한 가상 센서:
yaml
센서: "쾌적도 지수"
계산:
온도 (20-26°C): 50점
습도 (40-60%): 30점
CO2 (< 1000ppm): 20점
결과:
90-100점: 매우 쾌적
70-89점: 쾌적
50-69점: 보통
0-49점: 불쾌IFTTT 연동
외부 서비스와 연결:
- IFTTT 웹훅 설정
- Home Assistant 웹훅 URL 생성
- 트리거/액션 설정
예시:
- 날씨 흐림 → 실내 조명 밝게
- 캘린더 일정 → 자동화 실행
- 이메일 수신 → 알림 표시
15. 유용한 팁
효율적인 관리 팁
명명 규칙
좋은 예:
- 1층_거실_조명
- 2층_침실_에어컨
- 정문_센서
나쁜 예:
- 조명1
- 스위치
- 센서A그룹 활용
비슷한 장치를 그룹으로 관리:
- 모든 조명
- 1층 장치
- 보안 센서
정기 점검
- 주 1회: 자동화 동작 확인
- 월 1회: 불필요한 데이터 정리
- 분기 1회: 시스템 업데이트
성능 최적화
데이터베이스 관리
설정 → 시스템 → 리코더
보관 기간: 7일 (기본 10일)
제외 항목: 자주 변경되는 센서불필요한 통합 제거
설정 → 기기 및 서비스
사용하지 않는 통합 삭제16. 추천 하드웨어
입문자용 기기
| 카테고리 | 제품 | 가격대 | 특징 |
|---|---|---|---|
| 허브 | Zigbee USB 동글 | 3만원 | 다양한 기기 연결 |
| 조명 | Philips Hue | 3-5만원 | 색상 변경 가능 |
| 플러그 | TP-Link Kasa | 2만원 | 전력 측정 가능 |
| 센서 | Aqara 온습도 | 2만원 | 배터리 2년 |
| 스위치 | Sonoff Basic | 1만원 | DIY 가능 |
무인 공간 필수 기기
- 스마트 도어락: 원격 제어, 임시 비밀번호
- IP 카메라: CCTV, 동작 감지
- 전력 측정기: 에너지 모니터링
- 누수 센서: 화장실, 싱크대
- 연기 감지기: 화재 예방
17. 커뮤니티 및 지원
도움 받기
공식 자료
한국 커뮤니티
- 네이버 카페: "홈어시스턴트"
- 카카오톡 오픈채팅: "HA Korea"
- YouTube: "Home Assistant 한국"
문제 해결 순서
- 로그 확인
- 구글 검색
- 포럼 검색
- 커뮤니티 질문
업데이트 관리
안전한 업데이트
- 백업 먼저 생성
- 업데이트 노트 확인
- 중요하지 않은 시간에 진행
- 테스트 후 정상 확인
용어 정리
| 용어 | 설명 |
|---|---|
| 엔티티 | HA에서 제어하는 개별 항목 (조명, 센서 등) |
| 통합 | 외부 기기/서비스를 연결하는 구성요소 |
| 자동화 | 조건에 따라 자동 실행되는 규칙 |
| 스크립트 | 수동으로 실행하는 일련의 동작 |
| 장면 | 여러 기기의 상태를 저장한 프리셋 |
| 트리거 | 자동화를 시작하는 이벤트 |
| 조건 | 자동화 실행 여부를 결정하는 규칙 |
| 동작 | 자동화가 실행할 작업 |
| 대시보드 | 정보를 표시하는 화면 |
| 카드 | 대시보드의 개별 구성 요소 |
| 애드온 | HA에 추가 기능을 제공하는 프로그램 |
| YAML | HA 설정 파일 형식 |
💡 초보자를 위한 조언
- 하나씩 천천히 추가하며 테스트
- 자동화는 간단한 것부터 시작
- 백업은 정기적으로
- 커뮤니티를 적극 활용
⚠️ 주의사항
- 보안을 위해 외부 접속 시 VPN 사용 권장
- 중요한 장치는 수동 제어 옵션 유지
- 정기적인 업데이트로 보안 강화
- 자동화 오작동 대비 수동 해제 방법 숙지