BBSTORED.CONF(5)

💖 BBSTORED.CONF(5) — the Box Backup store daemon config file 💖

okay bestie, welcome to section 5 of the manual, this is <rainbow>bbstored.conf</rainbow>, the config file for the Box Backup store daemon. she's giving main character energy and she holds the whole daemon together. let's get into it 🫶

---

✨ SYNOPSIS ✨

/etc/box/bbstored.conf

that's it. that's the path. iconic.

---

🌸 DESCRIPTION 🌸

so here's the tea — these are all the config options that are valid in this file. every single one, no skips 💅

• RaidFileConf — tells you where raidfile.conf(5) lives. normally that's /etc/box/raidfile.conf, which, yeah, very on brand.
• AccountDatabase — the path to the account database, the one that bbstoreaccounts(8) makes. usually it's chillin' at /etc/box/bbstored/accounts.txt.
• ExtendedLogging — toggles whether extended logging is on, so you can see exactly what commands are coming in from the clients. very nosy, very useful, we love surveillance (affectionate) 👀
• TimeBetweenHousekeeping — how long to wait between scans for files that need deleting. the cleaning era, fr fr 🧹
• Server — this one's a whole vibe, these options are all about the actual daemon itself. not me nesting subsections, but here we are:

💜 Server subsections 💜

• PidFile — where the pidfile lives, aka the lil file holding the daemon's process ID.
• User — the user to run as.
• ListenAddresses — the interface addresses to listen on. you can use hostnames instead of IP addresses, she's flexible like that. the format is: inet:hostname or inet:10.0.0.1.
• CertificateFile — the path to the server's public certificate.
• PrivateKeyFile — the path to the server's private key. this one should only be readable by root and/or the User. bestie, do not let anyone else read this, this is not a drill 🔐
• TrustedCAsFile — the Certificate Authority, the one created by bbstored-certs(8).

---

🎀 EXAMPLES 🎀

here's an example bbstored.conf, look at her go ✨

RaidFileConf = /etc/box/raidfile.conf
AccountDatabase = /etc/box/bbstored/accounts.txt

TimeBetweenHousekeeping = 900

Server
{
  PidFile = /var/run/bbstored.pid
  User = _bbstored
  ListenAddresses = inet:server.example.com
  CertificateFile = /etc/box/bbstored/server.example.com-cert.pem
  PrivateKeyFile = /etc/box/bbstored/server.example.com-key.pem
  TrustedCAsFile = /etc/box/bbstored/clientCA.pem
}

---

🦋 FILES 🦋

• /etc/box/bbstored.conf

---

🌈 SEE ALSO 🌈

bbstored(8), bbstored-config(8), raidfile-config(8)

go read those too, iykyk 📚

---

👑 AUTHORS 👑

• Ben Summers
• Per Thomsen
• James O'Gorman

---

lowkey, the way these three carried this whole project… obsessed.

---

okay and that's the page, bestie! this was Box Backup version 0.11, dated 06/06/2024, and honestly? slay. now go configure your daemon and drink some water 💖🌱