MELI.CONF.EXAMPLES(5)

📦
version 0.8.13 · 2 versions
, in alpine 3.24, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💖 meli.conf.examples 💖

okay bestie so this is the page for meli.conf.examples — it's literally a grab-bag of example configs for all the mail backends that meli(1) (your terminal e-mail client, the moment) can talk to. every backend gets its own little demo config so you can copy-paste and vibe. no cap.

✨ MAILDIR ACCOUNT ✨

a whole example config, just for you:

[accounts.account-name]
root_mailbox = "/path/to/root/folder"
format = "Maildir"
listing.index_style = "Compact"
identity="email@example.com"
display_name = "Name"
send_mail = 'msmtp --read-recipients --read-envelope-from'
#send_mail = { hostname = "smtp.example.com", port = 587, auth = { type = "auto", username = "user", password = { type = "command_eval", value = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }

# Set mailbox-specific settings
  [accounts.account-name.mailboxes]
  "INBOX" = { alias="Inbox" } #inline table
  "drafts" = { alias="Drafts" } #inline table
  [accounts.account-name.mailboxes."foobar-devel"] # or a regular table
    ignore = true # don't show notifications for this mailbox

like, you can do your per-mailbox settings as inline tables OR as a regular table, your choice, both slay. setting ignore = true means no notifications for that mailbox, so it's giving peace and quiet 🦋

🌸 MBOX ACCOUNT 🌸

another example, here u go:

[accounts.account-name]
root_mailbox = "/var/mail/username"
format = "mbox"
listing.index_style = "Compact"
identity="username@hostname.local"
send_mail = '/bin/false'

🎀 IMAP ACCOUNT 🎀

[accounts."account-name"]
root_mailbox = "INBOX"
format = "imap"
server_hostname="mail.example.com"
server_password="pha2hiLohs2eeeish2phaii1We3ood4chakaiv0hien2ahie3m"
server_username="username@example.com"
#server_port="993" # imaps
server_port="143" # STARTTLS
use_starttls=true #optional
send_mail = { hostname = "smtp.example.com", port = 587, auth = { type = "auto", username = "user", password = { type = "command_eval", value = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }
display_name = "Name Name"
identity = "username@example.com"
## show only specific mailboxes:
#subscribed_mailboxes = ["INBOX", "INBOX/Sent", "INBOX/Drafts", "INBOX/Junk"]

ok so server_port="993" is the imaps one (it's commented out up there) and server_port="143" is the STARTTLS one. use_starttls=true is optional, and yes that subscribed_mailboxes line is how you'd show only specific mailboxes — it's commented out but it's right there waiting for you 💅

💌 Gmail account example 💌

[accounts."account-name"]
root_mailbox = '[Gmail]'
format = "imap"
send_mail = { hostname = "smtp.gmail.com", port = 587, auth = { type = "auto", username = "user", password = { type = "command_eval", value = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }
server_hostname='imap.gmail.com'
server_password="password"
server_username="username@gmail.com"
server_port="993"
listing.index_style = "Conversations"
identity = "username@gmail.com"
display_name = "Name Name"
# Gmail auto saves sent mail to Sent folder, so don't duplicate the effort:
composing.store_sent_mail = false

the tea here: Gmail auto saves your sent mail into the Sent folder, so don't duplicate the effort — that's why composing.store_sent_mail = false. iconic behavior tbh 🙈

🧚 JMAP ACCOUNT 🧚

heads up: the server_url option must hold the address of the server's session endpoint. not optional, bestie.

[accounts."account-name"]
root_mailbox = "INBOX"
format = "jmap"
send_mail = 'server_submission'
server_url="http://localhost:8080"
server_username="user@hostname.local"
server_password="changeme"
identity = "user@hostname.local"

🦋 fastmail.com account example 🦋

Fastmail: https://fastmail.com/ uses the Bearer token authentication mechanism, so the option use_token must be enabled:

[accounts."fastmail-jmap"]
root_mailbox = "INBOX"
format = "jmap"
server_url="https://api.fastmail.com/jmap/session"
server_username="user@fastmail.com"
server_password="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
use_token=true
identity = "My Name <user@fastmail.com>"
send_mail = "server_submission"

💜 NOTMUCH ACCOUNT 💜

TODO 😭

⭐ NNTP / USENET ACCOUNT ⭐

TODO 😭

🔥 SEE ALSO 🔥

👑 AUTHORS 👑

Copyright 2017–2024 Manos Pitsidianakis <manos@pitsidianak.is>

Released under the GPL, version 3 or greater. This software carries no warranty of any kind. (See COPYING for full copyright and warranty notices.)

and that's the whole page, bestie 💖 this one shipped from Debian on November 22, 2024 — go forth and configure, you've got this 🫶✨

📦 where this page comes from