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
42 lines
1.1 KiB
Markdown
42 lines
1.1 KiB
Markdown
---
|
|
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
|