NAME

     meli.conf examples — Example configurations for various mail backends supported by the
     meli(1) terminal e-mail client

MAILDIR ACCOUNT

     An example configuration:

     [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

MBOX ACCOUNT

     An example configuration:

     [accounts.account-name]
     root_mailbox = "/var/mail/username"
     format = "mbox"
     listing.index_style = "Compact"
     identity="username@hostname.local"
     composing.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"]

   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

JMAP ACCOUNT

     The server_url option must hold the address of the server's session endpoint.

     [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

     meli.conf(5), meli(1), meli-themes(5)

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.)

   Links
     Website: https://meli-email.org
     Main git repository and issue tracker: https://git.meli-email.org/meli/meli
     Official read-only git mirror on codeberg.org: https://codeberg.org/meli/meli
     Official read-only git mirror on github.com: https://github.com/meli/meli
     meli crate on crates.io: https://crates.io/crates/meli