e4d91aadf9
- Full Obsidian vault content - Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte) - Media stack documentation - Traefik HA setup - Automation scripts - Bachelor party planning
65 lines
1.8 KiB
Markdown
65 lines
1.8 KiB
Markdown
---
|
|
project:
|
|
name: VM Storage Policy
|
|
status: active
|
|
category: configuration
|
|
source: live-verification
|
|
created: 2026-01-06
|
|
updated: 2026-04-19
|
|
description: Storage rules for application data on the Ubuntu host (192.168.50.61)
|
|
tags: [documentation, storage, policy]
|
|
---
|
|
|
|
# VM Storage Policy for Application Data
|
|
|
|
All agents and developers managing services on the Ubuntu host (192.168.50.61) MUST follow these storage rules.
|
|
|
|
## Rule 1: User-Uploaded Data on NFS
|
|
|
|
Store ALL user-uploaded data on TrueNAS NFS shares, NOT on the VM's local disk.
|
|
|
|
**Allowed NFS Paths:**
|
|
- `/mnt/PersonalMediaLibrary/` — Personal media, photos (Immich)
|
|
- `/mnt/truenas/mediadata/` — Media library (Movies, TV, Music)
|
|
- `/mnt/truenas-backup/` — Backups
|
|
|
|
**Examples:**
|
|
```yaml
|
|
volumes:
|
|
- /mnt/PersonalMediaLibrary/immich/upload:/usr/src/app/upload
|
|
- /mnt/truenas/mediadata/media:/media
|
|
```
|
|
|
|
## Rule 2: Config Files on VM
|
|
|
|
Configuration files, databases, and cached data CAN stay on VM local disk.
|
|
|
|
**Allowed Local Paths:**
|
|
- `/home/bear/homelab/ubuntu/{service}/` — Docker compose and config
|
|
- `./config`, `./cache` (relative to docker-compose) — Config/cache directories
|
|
|
|
## Rule 3: NFS Mounts Must Be in fstab
|
|
|
|
Before using an NFS path in docker-compose, verify it exists in `/etc/fstab` for persistence.
|
|
|
|
```bash
|
|
cat /etc/fstab | grep nfs
|
|
```
|
|
|
|
## Summary
|
|
|
|
| Data Type | Storage Location | Example |
|
|
|-----------|-----------------|---------|
|
|
| User uploads | NFS (TrueNAS) | Photos, media |
|
|
| App config | VM local | docker-compose.yml, config/ |
|
|
| Databases | VM local (postgres-shared) | PostgreSQL, Redis |
|
|
| Media library | NFS (TrueNAS) | Movies, TV, Music |
|
|
| Backups | NFS (TrueNAS) | Application backups |
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- [[project.md|AI Assistant Project]]
|
|
- [[../../homelab/architecture.md|Homelab Architecture]]
|