Differences

This shows you the differences between two versions of the page.

--- notes:email-configuration [2026/05/31 14:24] – [Notes on Email Configuration] sam
+++ notes:email-configuration [2026/06/02 22:55] (current) – Add a note about mbsync sam
@@ Line 9: / Line 9: @@
 I got all of the software from ''brew''.
-The packages required are ''davmail'', ''isync'' (which provides the ''mbsync'' executable), and ''msmtp''.
+The packages required are ''davmail'', ''isync'' (which provides the ''mbsync'' executable), ''msmtp'', and ''mu''.
 ==== davmail ====
@@ Line 79: / Line 79: @@
 <code>
+### University Email (using davmail)
 IMAPAccount <account name>
 Host 127.0.0.1
 Port 6001
 User <my email>
-PassCmd "security find-generic-password -a umail -s mbsync -w"
+PassCmd "security find-generic-password -a <my email> -s <my account name> -w"
 TLSType None
 AuthMechs LOGIN
@@ Line 90: / Line 92: @@
 Account <account name>
-MaildirStore uchicago-local
+MaildirStore <account name>-local
 Path ~/Mail/<account name>-mail/
 Inbox ~/Mail/<account name>-mail/INBOX
 SubFolders Verbatim
-Channel uchicago
+Channel <account name>
 Far :<account name>-remote:
 Near :<account name>-local:
+Patterns *
+SyncState *
+Create Both
+Sync All
+Expunge Near
+### Gmail
+IMAPAccount gmail
+Host imap.gmail.com
+Port 993
+TLSType IMAPS
+AuthMechs LOGIN # <-- Note this line
+User <my gmail>@gmail.com
+PassCmd "security find-generic-password -a <my gmail>@gmail.com -s <my gmail> -w"
+IMAPStore gmail-remote
+Account gmail
+MaildirStore gmail-local
+Path ~/Mail/gmail-mail/
+Inbox ~/Mail/gmail-mail/INBOX
+SubFolders Verbatim
+Channel gmail
+Far :gmail-remote:
+Near :gmail-local:
 Patterns *
 SyncState *
@@ Line 107: / Line 136: @@
 ''PassCmd'' is a command to run to find your account password.
 We can use macOS' ''security'' command to call up the password from keychain when it's required, rather than writing it in plain text in the configuration file.
+Note that in the case of Gmail, the password stored in the keychain is an application password, since google does not permit IMAP authentication using your account password.
+Adding ''AuthMechs LOGIN'' was also necessary to get authentication to work (see [[https://frostyx.cz/posts/synchronize-your-2fa-gmail-with-mbsync|this blog post]]).
 Running ''mbsync <account name>'' will sync the local mail directory specified as above with the server.
+Passing ''-a'' will cause //all// accounts to be synchronized.
+==== msmtp ====
+''msmtp'' is used to send mail. It's configuration (''~/.msmtprc'') is as follows:
+<code>
+defaults
+logfile ~/Mail/msmtp.log
+tls_trust_file system # Use the system's tls certificate
+### University Email
+account <account name>
+host 127.0.0.1
+port 6003
+protocol smtp
+auth plain
+tls off
+user <my email>
+from <my email>
+passwordeval "security find-generic-password -a <my email> -s <my account name> -w"
+### Gmail
+account gmail
+auth on
+host smtp.gmail.com
+port 465
+protocol smtp
+from <my gmail>@gmail.com
+user <my gmail>@gmail.com
+passwordeval "security find-generic-password -a <my gmail>@gmail.com -s <my gmail> -w"
+tls on
+tls_starttls off
+# Default
+account default : <account name>
+</code>