Initial commit: homelab infrastructure wiki

- Full Obsidian vault content
- Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte)
- Media stack documentation
- Traefik HA setup
- Automation scripts
- Bachelor party planning

homelab/entities/rustfs.md

@@ -0,0 +1,41 @@
+---
+title: rustfs
+created: 2026-04-28
+updated: 2026-04-28
+type: entity
+tags: [services, storage, s3]
+sources: []
+confidence: medium
+---
+
+# rustfs
+
+**Role:** S3-compatible object storage
+**Host:** [[truenas]] (Docker with bind mount)
+**Data dir:** `/mnt/TrueNAS/rustfs/`
+
+## Overview
+
+rustfs provides S3-compatible object storage backed by [[truenas]] ZFS pool. It runs as a Docker container on the host that has access to the TrueNAS NFS share.
+
+## ⚠️ Critical Gotcha
+
+rustfs **ignores** `RUSTFS_S3_ACCESS_KEY` and `RUSTFS_S3_SECRET_KEY` environment variables on first boot — it uses hardcoded defaults:
+- Access key: `rustfsadmin`
+- Secret key: `rustfsadmin`
+
+This means whatever's passed via env vars is silently discarded on first start.
+
+## Reset Procedure
+
+If you need to reset rustfs (change credentials, recover from misconfiguration):
+1. Stop the rustfs container
+2. Wipe the data directory: `rm -rf /mnt/TrueNAS/rustfs/*`
+3. Restart the container
+4. rustfs re-initializes with the env vars now taking effect
+
+**Wiping the data dir is required** — just stopping the container is not enough.
+
+## Related
+
+- [[truenas]] — Storage backend