diff --git a/docs/nas-deploy-guide.md b/docs/nas-deploy-guide.md
index d39111e..a6a6e47 100644
--- a/docs/nas-deploy-guide.md
+++ b/docs/nas-deploy-guide.md
@@ -321,6 +321,7 @@ PocketBase 컨테이너는 **기본적으로 HTTPS(TLS)를 제공하지 않는
 | 컨테이너 이름 충돌 | `pocketbase-todo`·`todo-web`이 이미 있으면 `docker-compose.yaml`의 `container_name`을 바꾼다. |
 | `fatal: not a git repository` | `apps`가 아니라 **`cd todo`(클론한 폴더)** 안에서 실행했는지 확인한다. |
 | `git pull`이 안 되거나 안 받아짐 | 10절 순서대로 `git status`·`fetch`·`checkout main`·`pull --ff-only`, 로컬 수정·비공개 저장소 자격 확인 |
+| `untracked working tree files would be overwritten` (`docker-compose.yaml` 등) | 그 파일이 **추적되지 않은 로컬 파일**이라 pull이 덮어쓰기를 거부한 것이다. 백업 후 `mv docker-compose.yaml docker-compose.yaml.bak` 또는 삭제한 뒤 `git pull`한다. 필요하면 `diff`로 원격과 맞춘 뒤 수동 병합한다. |
 | `ERR_SSL_VERSION_OR_CIPHER_MISMATCH` (`https://api…`) | 11-1절. 프록시 443·인증서·`proxy_pass`가 PB **HTTP** 포트로 가는지 확인 |
 | PocketBase `unable to open database file (14)` | `./pb_data` 쓰기 권한. `docker-compose.yaml`에서 `user: "1000:10"`을 켠 상태면 호스트에서 `sudo chown -R 1000:10 pb_data`. 또는 `user` 줄을 주석으로 둔 채 기동해 DB 생성 후 `chown`하고 `user` 재적용. |