112 lines
5.2 KiB
Markdown
112 lines
5.2 KiB
Markdown
---
|
|
schema_version: 1
|
|
id: home-server.storage
|
|
type: reference
|
|
scope: [jupiter, disks, raid, filesystems, docker-volumes, media-import]
|
|
sensitivity: private-infrastructure
|
|
last_reviewed: "2026-10-27"
|
|
sources:
|
|
- kind: owner-report
|
|
reference: "lsblk/mdadm/fstab/findmnt/volume snapshots 2026-10-06; local hardlinks/imports and remote-mount removal confirmed 2026-10-26"
|
|
- kind: repository
|
|
repository: jupiter-stacks
|
|
revision: working-tree
|
|
base_revision: 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
|
|
paths: [stacks/downloads/docker-compose.yml, stacks/sonarr/docker-compose.yml, stacks/radarr/docker-compose.yml]
|
|
related: [home-server.host, home-server.downloads, home-server.backups]
|
|
update_triggers: [disk-change, raid-change, mount-change, volume-change]
|
|
unknowns: [persistent-mdadm-config-and-initramfs, disk-health]
|
|
---
|
|
|
|
# Storage
|
|
|
|
## Physical placement
|
|
|
|
```mermaid
|
|
---
|
|
config:
|
|
themeCSS: |
|
|
text,.nodeLabel,.cluster-label { fill:var(--infra-text);color:var(--infra-text); }
|
|
.flowchart-link { stroke:var(--infra-line); }
|
|
marker path { fill:var(--infra-line);stroke:var(--infra-line); }
|
|
.cluster rect { fill:var(--infra-zone);stroke:var(--infra-border);stroke-dasharray:5 5;rx:12px;ry:12px; }
|
|
.cluster span,.cluster text { color:var(--infra-text)!important;fill:var(--infra-text)!important; }
|
|
.infraStorage rect,.infraStorage path { fill:var(--infra-storage-fill);stroke:var(--infra-storage-stroke); }
|
|
.infraEdge rect { fill:var(--infra-edge-fill);stroke:var(--infra-edge-stroke);rx:8px;ry:8px; }
|
|
.infraService rect { fill:var(--infra-service-fill);stroke:var(--infra-service-stroke);rx:8px;ry:8px; }
|
|
---
|
|
flowchart TB
|
|
accTitle: SSD system storage and non-redundant HDD application storage
|
|
accDescr: Docker volumes and caches are on SSD; service bind mounts, downloads and libraries are on the striped HDD array.
|
|
subgraph SSD["SSD / SAMSUNG 860 EVO / 1 TB"]
|
|
Root["sdc3 / ext4 root"]:::infraStorage
|
|
Docker["/var/lib/docker<br/>/var/lib/containerd"]:::infraService
|
|
Cache["/home/jay/data<br/>service caches"]:::infraService
|
|
Root --> Docker
|
|
Root --> Cache
|
|
end
|
|
subgraph HDD["HDD / 2 x SEAGATE BARRACUDA / 2 TB EACH"]
|
|
Disks["sdb1 + sda1"]:::infraStorage
|
|
RAID["md0 / RAID 0<br/>3.64 TiB / no redundancy"]:::infraEdge
|
|
Data[("/data / ext4<br/>bind mounts + media")]:::infraStorage
|
|
Disks --> RAID --> Data
|
|
end
|
|
```
|
|
|
|
- Either HDD failure loses the array, including application state; [backup coverage](backups.md#coverage) is explicit, not all of `/data`.
|
|
- SSD cache paths: `/home/jay/data/{backrest/cache,jellyfin/cache,wardrowbe/ollama,wardrowbe/rembg}`.
|
|
- `/data/<service>` holds service bind mounts; application-specific mappings live on each service page.
|
|
- Wardrowbe binds: `/data/wardrowbe/{postgres,uploads,redis}`; SSD models/caches above.
|
|
|
|
## RAID / mounts
|
|
|
|
| Setting | Snapshot value |
|
|
| --- | --- |
|
|
| Array | Linux MD `/dev/md0` (`/dev/md/0` scan name); ext4 directly, no LVM |
|
|
| MD UUID / label | `c67fccaa:e541bf2d:2bf68322:1086e0e9` / `jupiter:0` |
|
|
| Metadata / layout / chunk | `1.2` / `original` / 512 KiB |
|
|
| Member order | Slot 0 `/dev/sdb1`; slot 1 `/dev/sda1` |
|
|
| State | Clean, 2 active, no failed/spare members at inspection |
|
|
| `/data` options | `rw,relatime,stripe=256`; `/tmp` is tmpfs |
|
|
| SSD partitions | `sdc1` EFI; `sdc2` swap; `sdc3` root |
|
|
|
|
Supplied `/etc/fstab`:
|
|
|
|
```fstab
|
|
UUID=7a5e0ee6-4a65-4f68-9128-b3b4f3406447 / ext4 errors=remount-ro 0 1
|
|
UUID=1DDE-CDF9 /boot/efi vfat utf8 0 0
|
|
UUID=d60390a1-7db3-44cc-bbde-693c23e42001 /data ext4 defaults 0 2
|
|
UUID=4781ea5d-fba5-438d-8d97-6a0801669ca1 none swap sw 0 0
|
|
```
|
|
|
|
- Device names are snapshots; UUIDs identify filesystems.
|
|
- Persisted mdadm/initramfs configuration unverified. **Assembly is not creation: do not use `mdadm --create`.**
|
|
|
|
## Media mounts
|
|
|
|
| Consumer | Host -> container | Paths |
|
|
| --- | --- | --- |
|
|
| qBittorrent | `/data/jellyfin/torrents:/media/torrents` | `incomplete`, `movies`, `tv`; no organised-library mount |
|
|
| Sonarr / Radarr | `/data/jellyfin:/media` | Roots `/media/tv_shows`, `/media/movies`; categories `sonarr` -> torrents `tv`, `radarr` -> torrents `movies` |
|
|
| Jellyfin | `/data/jellyfin:/media` | Library roots exclude `torrents` |
|
|
|
|
- Same-filesystem hardlink imports confirmed; no second full copy while seeding.
|
|
- Unlinking one name preserves data while another link exists; hardlinks are **not backups**.
|
|
- Download service/configuration: [AirVPN](downloads.md). Former FUSE mount is retired.
|
|
|
|
## Named volumes
|
|
|
|
Snapshot: driver `local`, no options; `/var/lib/docker/volumes/<name>/_data` on SSD.
|
|
|
|
| Volume | Consumer path |
|
|
| --- | --- |
|
|
| `audiobookshelf_config` | Audiobookshelf `/config` |
|
|
| `jellyfin_config` | Jellyfin `/config` |
|
|
| `notes_static` | Builder `/site-output`; web `/usr/share/nginx/html` |
|
|
| `dozzle_dozzle_data` | Dozzle `/data` |
|
|
| `ctq_ctq_postgres_data` | CTQ PostgreSQL `/var/lib/postgresql/data` |
|
|
| `havox_src` | Havox web/sync `/git` |
|
|
|
|
- `jellyfin_cache`, `notes_notes_static` and monitoring volumes had no shown running consumer; **not evidence they are safe to delete**.
|
|
- Named-volume recovery is separate from `/data` bind mounts: [Backups](backups.md#recovery-limits).
|