chasquid(1)

✨ NAME ✨

okay so bestie, welcome to the chasquid(1) manual page 💖 — this one's about chasquid, and it's literally an SMTP (email) server. that's the whole vibe. let's get into it 🎀

---

🌸 SYNOPSIS 🌸

chasquid [options...]

---

🦋 DESCRIPTION 🦋

so chasquid is an SMTP (email) server that's hyperfocused on three things, no cap: simplicity, security, and ease of operation. it's giving "i just want my mail server to work and not be a whole ordeal" energy 💅

it's written in Go, and it's distributed under the Apache license 2.0. periodt. ✨

---

💅 OPTIONS 💅

• -config_dir dir — this is where the config lives. default is /etc/chasquid 💖
• -config_overrides config — config values (in text protobuf format) that override whatever's on disk. lowkey you should basically never need this, bestie — it's only for those very specific deployment situations where editing the config file just isn't feasible 🙈
• -alsologtostderr — also log to stderr, on top of logging to the file. why not both, right ✨
• -logfile file — the file to log to. heads up: this one enables logtime for you 🔥
• -logtime — include the time when writing the log to stderr ⭐
• -logtosyslog tag — log to syslog, with the tag you give it 🎀
• -v level — verbosity level (1 = debug) 👑
• -version — show version and exit. short, sweet, iconic 💀

---

🎀 FILES 🎀

okay so the daemon's config is by default in /etc/chasquid/, and you can change that with the -config_dir flag. slay.

inside that directory, the daemon expects this exact structure, no notes:

• chasquid.conf — the main config file, see chasquid.conf(5) 💖
• domains/ — per-domain configuration
• domains/example.com/ — domain-specific configuration. can be empty, she's low maintenance 🦋
• domains/example.com/users — the user and password database for this domain
• domains/example.com/aliases — aliases for the domain
• certs/ — certificates to use, one directory per pair
• certs/mx.example.com/ — certificates for this domain
• certs/mx.example.com/fullchain.pem — the certificate (full chain)
• certs/mx.example.com/privkey.pem — the private key 🔐

ngl the certs/ directory layout matches the one from certbot (the client for Let's Encrypt CA), so you can literally just symlink certs/ to /etc/letsencrypt/live. iykyk ✨

⚠️ okay important one: make sure the user you run chasquid under ("mail" in the example config) can actually access the certificates and private keys. fr fr, don't skip this 🫶

---

💜 CONTACT 💜

main website: <https://blitiri.com.ar/p/chasquid> 🌈

if you've got questions, comments, or patches, please send them to the mailing list at chasquid@googlegroups.com 💌 and to subscribe, just email chasquid+subscribe@googlegroups.com. come hang out bestie 🎀

---

🌟 SEE ALSO 🌟

• chasquid-util(1)
• chasquid.conf(5)

---

and that's the whole page, bestie 💖 this was chasquid(1), dated 2023-10-03, from the chasquid crew. go forth and send some email, you've got this 👑✨🌸