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

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

## 빠른 시작 (dev, SQLite + Ollama)

```bash
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 + 리소스 제한)

```bash
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`(마이그레이션·백업/복구·모니터링·장애·롤백) 참고.