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 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 <container-name> --tail 100 -f
docker logs container-name --tail 100 -f
```
### Recreate with Labels (Unraid)