---
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