ari_assistant/deploy/README.md

아리(Ari) 셀프호스트 가이드 (phase-15)

로컬-퍼스트(홈서버) 자기호스트 — 데이터가 머신을 떠나지 않습니다(Ollama 로컬 LLM + SQLite).

빠른 시작 (dev, SQLite + Ollama)

cd deploy
cp .env.prod.example .env.prod
# 비밀 생성
docker compose run --rm backend python -m scripts.gen_secret   # SESSION_SECRET / ARI_SECRET_KEY → .env.prod
# 기동
docker compose up -d --build
# 마이그레이션 + 시드
docker compose run --rm backend alembic upgrade head
docker compose run --rm backend python -m app.seed
# Ollama 모델(선택 — 없으면 heuristic 폴백)
docker compose exec ollama ollama pull qwen2.5:7b

→ https://ari.localhost (Caddy 자체서명) 또는 ARI_DOMAIN 설정 후 실도메인.

• 로그인: jiwoo@lumi.co / demo-1234(.env.prod 에서 변경 권장).
• liveness https://<도메인>/api/health, readiness /api/ready.

prod (Postgres + 리소스 제한)

mkdir -p secrets && echo "강한_비밀번호" > secrets/pg_password.txt
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build
docker compose run --rm backend alembic upgrade head

데모 모드(인증 끔)

AUTH_ENABLED=false(기본) + NEXT_PUBLIC_AUTH_ENABLED 미설정이면 로그인 없이 단일 데모 사용자(지우)로 전 페이지 동작 — phase 0~14 와 100% 동일.

운영

docs/RUNBOOK.md(마이그레이션·백업/복구·모니터링·장애·롤백) 참고.