virtual-insanity
← 리포트 목록

HA 재구축 해리 수동 가이드

2026-04-24 ha [home-assistant, ha, manual, colima, rebuild]

HA 재구축 해리 수동 가이드

현재 확인한 사실: - 로컬 HA 서비스 뼈대는 이미 /Users/ron/.hermes/services/homeassistant/에 준비되어 있음. - Colima/Docker가 꺼져 있으면 HA 컨테이너는 뜨지 않음. - 기존 Hostinger 주소 https://srv1321629.hstgr.cloud는 DNS/VPS 쪽이 죽어 있어, 오늘은 로컬 HA를 먼저 살리는 방식으로 진행.

비유하면, 오늘 작업은 “집을 새로 짓는 것”이 아니라 두꺼비집을 올리고 현관문까지 여는 단계다. Tuya/날씨/토큰은 집 안 가전 연결 단계라서 뒤로 뺀다.


Phase 1 — 오늘 할 일

1.1 Colima 시작 — 예상 5~15분

터미널에 그대로 붙여넣기:

colima start --cpu 4 --memory 6 --disk 40

끝나면 확인:

docker context use colima
docker info | head -20

정상 화면: - Server: 섹션이 보임 - Cannot connect to the Docker daemon 문구가 없어야 함

실패 시 대응:

증상 대응
Cannot connect to the Docker daemon colima status 실행 후 꺼져 있으면 colima start --cpu 4 --memory 6 --disk 40 재실행
colima already running 정상. 다음 단계 진행
오래 멈춘 것처럼 보임 5분 기다린 뒤 새 터미널에서 colima status 확인
계속 실패 아래 로그만 복사해서 보내기: colima status && docker info | head -40

1.2 HA 컨테이너 시작 — 예상 3~8분

Colima가 켜진 뒤 실행:

cd /Users/ron/.hermes/services/homeassistant
./start.sh

정상 확인:

docker ps --filter name=homeassistant

정상 화면: - homeassistant 컨테이너가 보임 - STATUSUp ...로 표시됨

실패 시 대응:

cd /Users/ron/.hermes/services/homeassistant
./logs.sh

마지막 30줄만 복사해서 보내면 됨.


1.3 브라우저 열기 전 준비 확인 — 예상 1~3분

curl -I http://localhost:8123 2>/dev/null | head

정상 후보: - HTTP/1.1 200 OK - 또는 초기 로딩 중이면 HTTP/1.1 302 / HTTP/1.1 405도 가능

안 열리면:

docker logs homeassistant --tail 100

Starting Home Assistant 이후 첫 부팅은 2~5분 걸릴 수 있음.


1.4 브라우저 초기 설정 — 예상 10~20분

브라우저 열기:

open http://localhost:8123

화면 흐름:

  1. Welcome / Create my smart home
  2. 새 관리자 계정 생성
  3. 이름/아이디/비밀번호 입력
  4. 비밀번호는 나중에 다시 보기 어렵기 때문에 저장

  5. Home name / Location / Time zone

  6. 집 이름: Harry Home 또는 원하는 이름
  7. 위치: 현재 위치 허용 또는 수동 설정
  8. Time zone: Asia/Seoul
  9. 단위: metric

  10. Detected devices / Integrations 발견 화면

  11. 오늘은 급하게 다 연결하지 말고, 발견된 장치가 보여도 일단 넘겨도 됨
  12. Tuya/날씨는 Phase 2에서 차분히 연결

  13. Overview 대시보드 진입

  14. 왼쪽 메뉴에 Settings, Devices & services가 보이면 성공

실패 시 대응:

증상 대응
브라우저가 안 열림 docker ps --filter name=homeassistant 확인
8123 접속 거부 docker logs homeassistant --tail 100 확인, 2~5분 대기
계정 생성 화면 반복 브라우저 새로고침 후 다시 시도
설정 중 막힘 화면 캡처 또는 문구만 보내기

Phase 2 — 해리 시간 될 때 할 일

2.1 Tuya 통합 — 예상 10~20분

브라우저에서:

  1. SettingsDevices & services
  2. Add Integration
  3. Tuya 검색
  4. Smart Life/Tuya 앱에서 쓰는 계정으로 로그인
  5. 지역/국가는 앱 계정과 동일하게 선택

주의: - Tuya는 계정 지역이 다르면 장치가 0개로 보일 수 있음. - 장치가 안 보이면 앱에서 로그인한 국가/지역과 HA 설정 지역부터 맞춘다.


2.2 날씨 통합 — 예상 5~10분

브라우저에서:

  1. SettingsDevices & services
  2. Add Integration
  3. 우선 기본 날씨 통합 또는 Meteorologisk institutt 검색
  4. 위치 확인

OpenWeatherMap처럼 API Key가 필요한 통합은 나중에 해도 됨. 오늘 목표는 “날씨 엔티티가 하나라도 생기는 것”.


2.3 Long-Lived Token 발급 — 예상 3~5분

브라우저에서:

  1. 왼쪽 아래 사용자 프로필 클릭
  2. Security 또는 페이지 하단의 Long-lived access tokens 이동
  3. Create Token
  4. 이름: hermes-smart-home
  5. 생성된 토큰을 한 번만 복사

토큰 저장 명령:

mkdir -p /Users/ron/.hermes/secrets
printf '%s' '여기에_복사한_토큰_붙여넣기' > /Users/ron/.hermes/secrets/ha_token
chmod 600 /Users/ron/.hermes/secrets/ha_token

API 확인:

curl -sS -H "Authorization: Bearer $(cat /Users/ron/.hermes/secrets/ha_token)" http://localhost:8123/api/

정상 응답:

{"message":"API running."}

오늘의 완료 기준

Phase 1 완료 기준: - colima status가 Running - docker pshomeassistant 표시 - http://localhost:8123 브라우저 접속 가능 - HA 초기 계정 생성 완료

Phase 2 완료 기준: - Tuya 장치 1개 이상 표시 또는 연동 실패 원인 확인 - 날씨 엔티티 1개 이상 생성 - /Users/ron/.hermes/secrets/ha_token 저장 - curl ... /api/API running 반환


Codex 확인 메모

  • 기존 OpenClaw 쪽 HA config는 /Users/ron/.openclaw/docker/homeassistant/config에 남아 있음.
  • 새 재구축 기준 경로는 /Users/ron/.hermes/services/homeassistant.
  • 기존 Hostinger/VPS 복구는 별도 문제. 오늘 로컬 HA가 먼저 살아야 Hermes 자동화와 다시 연결 가능.

자체평가

  • 정확성: 4.5/5
  • 완성도: 4.5/5
  • 검증: 4.0/5
  • 최소 변경: 5.0/5
  • 종합: 4.5/5

1단계 시작 DM 발송 기록

  • chat_id: 492860021
  • message_id: 12008
  • 발송 시각: 2026-04-24 KST
  • 내용: Colima 시작 명령, 예상 소요 15분, 다음 안내 대기