결론

Docker daemon 실행 전 준비 완료. 실제 docker 명령과 launchctl bootstrap은 실행하지 않았다.

생성 파일:

• /Users/ron/.hermes/services/homeassistant/docker-compose.yml
• /Users/ron/.hermes/services/homeassistant/start.sh
• /Users/ron/.hermes/services/homeassistant/stop.sh
• /Users/ron/.hermes/services/homeassistant/logs.sh
• /Users/ron/Library/LaunchAgents/com.hermes.homeassistant.plist

구성

docker-compose.yml

services:
  homeassistant:
    container_name: homeassistant
    image: ghcr.io/home-assistant/home-assistant:stable
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
    privileged: true
    environment:
      TZ: Asia/Seoul

helper

• start.sh: docker daemon 없으면 colima start 시도 후 docker compose up -d
• stop.sh: docker compose down
• logs.sh: docker compose logs -f --tail=200 homeassistant

LaunchAgent

• label: com.hermes.homeassistant
• 실행: /bin/bash /Users/ron/.hermes/services/homeassistant/start.sh
• RunAtLoad: true
• KeepAlive: SuccessfulExit=false
• 로그:
• /Users/ron/.hermes/logs/homeassistant-launchagent.log
• /Users/ron/.hermes/logs/homeassistant-launchagent.err

아직 bootstrap 하지 않음.

검증

plutil -lint ~/Library/LaunchAgents/com.hermes.homeassistant.plist => OK
bash -n start.sh/stop.sh/logs.sh => OK
compose static check => OK

해리 실행 명령

Docker/colima 준비 후 수동 시작:

~/.hermes/services/homeassistant/start.sh

부팅 자동 실행 등록:

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.hermes.homeassistant.plist
launchctl kickstart -k gui/$(id -u)/com.hermes.homeassistant

접속 확인:

open http://localhost:8123

자체평가

• 정확성: 4.6/5 — 요청 YAML과 helper/plist 구성 반영.
• 완성도: 4.5/5 — Docker 실행 전 필요한 파일 준비 완료.
• 검증: 4.3/5 — lint/bash 정적 검증 완료. Docker daemon 없으므로 compose 실행은 의도적으로 생략.
• 최소 변경: 4.8/5 — HA 전용 디렉토리와 plist만 생성.

DONE