SFSHDD.CFG(5)

📦
version 5.8.0 · 4 versions
, in ubuntu stonking

💖 sfshdd.cfg — the manual page (section 5, bestie) 💖

okay so. this is sfshdd.cfg(5), and if you're here it's bc you're setting up SaunaFS storage and you need to tell your chunkserver where all its lil drives live. pull up a chair, we're doing this together 🫶

✨ NAME ✨

sfshdd.cfg — the list of SaunaFS storage directories for sfschunkserver

🌸 DESCRIPTION 🌸

so basically, this file is just a vibe-coded little list: it holds all the directories (mountpoints, i.e. where drives are hanging out) that SaunaFS uses for storage. one per line, no cap.

there's two ✨special✨ line flavors you gotta know:

  • any directory with a /* prefix on it? yeah, that one gets freed — SaunaFS replicates everything already stored there over to other locations so the drive can be emptied out. bye bestie 💅
  • any line starting with # is just ignored. it's giving commentary, it's giving notes-to-self 📝

now here's the part where it gets iconic: the chunks get split into metadata parts and data parts.

  • metadata parts — the .met files, they hold info about the chunks
  • data parts — the .dat files, which are just the aligned data, nothing more

and the way that you can store the metadata in a totally different directory, or even on a whole separate drive?? just split the two paths with | like this:

/path/to/metadata | /path/to/data

this is lowkey my favorite feature bc it means you can put the metadata parts on, say, NVMe (fast, main character energy ⚡) and the data parts on HDD (chill, spacious, living its best life). slay.

🦋 HOST-MANAGED SMR SPECIFICS 🦋

ok if you're running the proprietary chunkserver plugin for Host-Managed SMR drives, you gotta use the zonefs: prefix. syntax goes like this:

[*]zonefs:/path/to/metadata | /path/to/data

for example:

zonefs:/mnt/nvme1 | /mnt/host-managed-smr1
⚠️ bestie listen — the /path/to/metadata should always be on a non-SMR drive. always. do not test this. 🙈

and that optional *? it means the exact same thing as above — it marks the drive for removal. same energy, different prefix 💅

😭 REPORTING BUGS 😭

found a bug? not you being the main character of QA 🫶 report it as an issue on the GitHub repository right here: https://github.com/leil-io/saunafs

Copyright 2008-2009 Gemius SA

Copyright 2013-2019 Skytechnology sp. z o.o.

Copyright 2023-2024 Leil Storage OÜ

SaunaFS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.

SaunaFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with SaunaFS. If not, see http://www.gnu.org/licenses/.

💜 SEE ALSO 💜

and that's the whole page, bestie 💖 this one's from SFSHDD.CFG(5), dated 2026-07-29 — go configure those drives, you got this ✨🎀🦋

📦 where this page comes from