docs: Add reboot persistence note and first-run command
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful

- Added IMPORTANT section explaining /tmp is not persistent
- Added first-run command to clone/pull infrastructure repo
- Added persistence note for /boot/config/
This commit is contained in:
2026-01-18 19:12:46 +02:00
parent 40f732fc53
commit 7a29f07fb4

View File

@@ -7,24 +7,37 @@
| Claude binary | `/root/.local/bin/claude` | | Claude binary | `/root/.local/bin/claude` |
| Claude data | `/mnt/user/appdata/claude-code/` | | Claude data | `/mnt/user/appdata/claude-code/` |
| Config | `~/.claude/` | | Config | `~/.claude/` |
| Project instructions | `/root/CLAUDE.md` (symlink to this file) |
**Run Claude:** `claude` or `/root/.local/bin/claude` **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 ## Infrastructure Documentation
**Repository:** https://git.xtrm-lab.org/jazzymc/infrastructure **Repository:** https://git.xtrm-lab.org/jazzymc/infrastructure
**Local clone:** `/tmp/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 ### Documentation Structure
``` ```
/tmp/infrastructure/docs/ /tmp/infrastructure/docs/
@@ -54,6 +67,8 @@ cd /tmp && \
| Disk shares | `/mnt/disk[1-n]/` | | Disk shares | `/mnt/disk[1-n]/` |
| Cache | `/mnt/cache/` | | Cache | `/mnt/cache/` |
**Persistence note:** Only `/boot/config/` survives reboots. All plugin configs, Docker templates, and custom scripts should be stored there.
--- ---
## Network Configuration ## Network Configuration
@@ -82,7 +97,7 @@ docker ps -a --format table {{.Names}}t{{.Status}} | sort
### Container Logs ### Container Logs
```bash ```bash
docker logs <container-name> --tail 100 -f docker logs container-name --tail 100 -f
``` ```
### Recreate with Labels (Unraid) ### Recreate with Labels (Unraid)