You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# 아리(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`(마이그레이션·백업/복구·모니터링·장애·롤백) 참고.
|