Files
hermes-ice/homelab/entities/rustfs.md
Hermes Agent e4d91aadf9 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
2026-05-24 16:08:40 -07:00

1.1 KiB

title, created, updated, type, tags, sources, confidence
title created updated type tags sources confidence
rustfs 2026-04-28 2026-04-28 entity
services
storage
s3
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.