diff --git a/docs/unraid-claude.md b/docs/unraid-claude.md index 53d409d..0d22c69 100644 --- a/docs/unraid-claude.md +++ b/docs/unraid-claude.md @@ -7,24 +7,37 @@ | Claude binary | `/root/.local/bin/claude` | | Claude data | `/mnt/user/appdata/claude-code/` | | Config | `~/.claude/` | +| Project instructions | `/root/CLAUDE.md` (symlink to this file) | **Run Claude:** `claude` or `/root/.local/bin/claude` --- +## IMPORTANT: First Run After Reboot + +The infrastructure documentation lives in `/tmp/infrastructure/` which is **NOT persistent** across Unraid reboots (tmp is cleared on restart). + +**Always run this command first when starting a new session:** + +```bash +cd /tmp && ([ -d infrastructure ] && cd infrastructure && git pull || git clone "https://jazzymc:zRuHTu%5D7Q3LC%2Bq%3F@git.xtrm-lab.org/jazzymc/infrastructure.git") +``` + +This command: +1. Checks if `/tmp/infrastructure` exists +2. If yes → pulls latest changes +3. If no → clones the repository fresh + +Without this, the `/root/CLAUDE.md` symlink will be broken and Claude won't have context. + +--- + ## Infrastructure Documentation **Repository:** https://git.xtrm-lab.org/jazzymc/infrastructure **Local clone:** `/tmp/infrastructure` -Always sync before making changes: -```bash -cd /tmp && \ - ([ -d infrastructure ] && cd infrastructure && git pull || \ - git clone "https://jazzymc:zRuHTu%5D7Q3LC%2Bq%3F@git.xtrm-lab.org/jazzymc/infrastructure.git") -``` - ### Documentation Structure ``` /tmp/infrastructure/docs/ @@ -54,6 +67,8 @@ cd /tmp && \ | Disk shares | `/mnt/disk[1-n]/` | | Cache | `/mnt/cache/` | +**Persistence note:** Only `/boot/config/` survives reboots. All plugin configs, Docker templates, and custom scripts should be stored there. + --- ## Network Configuration @@ -82,7 +97,7 @@ docker ps -a --format table {{.Names}}t{{.Status}} | sort ### Container Logs ```bash -docker logs --tail 100 -f +docker logs container-name --tail 100 -f ``` ### Recreate with Labels (Unraid)