From 42712927169321e6116c6364f4f389a118abb6c3 Mon Sep 17 00:00:00 2001
From: gm <weimdo_@naver.com>
Date: Sat, 23 May 2026 16:16:51 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=EC=B4=88=EA=B8=B0=20README=20=EC=9E=91?=
 =?UTF-8?q?=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 44 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 43 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b49ee63..6dd3053 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,45 @@
 # wikijs
 
-Wiki.js — Podman Quadlet 구성
\ No newline at end of file
+[Wiki.js](https://js.wiki/) Podman Quadlet 구성.  
+`postgres-main` 공유 인스턴스를 DB로 사용하고, `proxy.network`에 배치된다.
+
+## 서비스 정보
+
+| 항목 | 값 |
+|---|---|
+| 이미지 | `ghcr.io/requarks/wiki:2` |
+| 내부 주소 | `10.89.0.45:3000` |
+| 도메인 | `wiki.du5t.xyz` |
+| DB | `postgres-main` — `wikijs` 데이터베이스 |
+| 데이터 | `/podman/data/wikijs/data` |
+| 인증 | Authentik OIDC (관리자 패널에서 설정) |
+
+## 파일 구성
+
+```
+wikijs.container          ← Quadlet 컨테이너 정의
+wikijs.env.example        ← 환경변수 템플릿
+```
+
+실제 환경변수 파일은 `/podman/env/wikijs.env` (서버 로컬, 미추적).
+
+## 초기 설정 순서
+
+1. `systemctl start wikijs` 후 `wiki.du5t.xyz` 접속
+2. 관리자 이메일 / 비밀번호 설정 (Setup Wizard)
+3. 관리자 패널 → Authentication → Add → Generic OpenID Connect
+   - Authentik에서 OAuth2 Provider + Application 생성 후 Client ID/Secret 입력
+   - Callback URL: `https://wiki.du5t.xyz/login/4d0871b7-3a3b-49a4-bef2-b34618d5dbbd/callback`
+
+## 운영
+
+```bash
+# 상태 확인
+systemctl status wikijs
+
+# 로그
+podman logs --tail 50 wikijs
+
+# 재시작
+systemctl restart wikijs
+```