BBSTORED-CERTS(8)

📦
version 0.13~~git20231028.g3dd5194 · 7 versions
, in debian trixie, ubuntu questing

💖 BBSTORED-CERTS 💖 — the Box Backup cert page (section 8 of the manual, bestie)

okay so listen. this is the man page for bbstored-certs, living in section 8 of the Box Backup manual. no cap, it's the little tool that handles ALL your certificate drama for Box Backup. let's get into it 🎀

✨ SYNOPSIS ✨

bbstored-certs certs-dir command [arguments]

🌸 DESCRIPTION 🌸

bbstored-certs creates and signs certificates for use in Box Backup. it's giving "certificate girlboss" honestly 💅. it lets you create and sign the server keys, and it also signs client keys. that's the whole vibe.

lowkey important: all commands must be followed by the certs-dir, which is the directory in which the certificates are stored. that's not optional bestie, it's literally the first thing after the command name.

🦋 Commands 🦋

there are 3 commands. three. a trilogy. an iconique trio ✨

  • init — Create the certs-dir, and generate the server keys for bbstored. heads up: certs-dir cannot exist before running the command. like, it has to be brand new, no cap.
  • sign-server servercsrfile — Sign the server certificate. the servercsrfile is the file generated by the init command. yes, the one you just made. 🫶
  • sign clientcsrfile — Sign a client certificate. the clientcsrfile is generated during client setup. see bbackupd-config(8). then you send the signed certificate back to the client, and install according to the instructions given by bbackupd-config. don't skip the sending-back part, the client is literally waiting 😭

💜 FILES 💜

raidfile-config(8) generates the raidfile.conf(5) file. that's the whole section. short and sweet, periodt.

💀 BUGS 💀

if you find a bug in Box Backup, and you want to let us know about it, join the mailing list[1], and send a description of the problem there. we wanna hear it, fr fr.

to report a bug, give us at least the following information:

  • The version of Box Backup you are running
  • The platform you are running on (hardware and OS), for both client and server.
  • If possible attach your config files (bbstored.conf, bbackupd.conf) to the bug report.
  • Also attach any log file output that helps shed light on the problem you are seeing.
  • And last but certainly not least, a description of what you are seeing, in as much detail as possible.
no gatekeeping the details please — the more info you give, the faster someone can help you. 👑

🌈 SEE ALSO 🌈

bbstored-config(8), bbstored.conf(5), bbstoreaccounts(8)

👑 AUTHORS 👑

Ben Summers

Per Thomsen

James O'Gorman

🎀 NOTES 🎀

  1. mailing list http://lists.warhead.org.uk/mailman/listinfo/boxbackup

and that's the whole page bestie, you ate it 💅✨ this was Box Backup version 0.11, dated 06/06/2024, and the page itself is BBSTORED-CERTS(8). go forth and sign those certs 🦋💖

📦 where this page comes from