Msmtp: Difference between revisions

← Older edit

VisualWikitext

@@ Line 1: / Line 1: @@
-[https://marlam.de/msmtp/ msmtp] is a basic email sender client. It is easy to configure but lacks some features like queuing when offline.
+[https://marlam.de/msmtp/ msmtp] is an easy to configure basic email sender client with fairly complete sendmail compatibility.
 == Installation ==
@@ Line 10: / Line 10: @@
 programs.msmtp = {
    enable = true;
-   accounts = {
+   accounts.default = {
-     default = {
+     host = "example.org";
-      host = "example.org";
+    from = "hello@example.org";
-      from = "hello@example.org";
+    user = "hello@example.org";
-      user = "hello@example.org";
+    password = "mypassword123";
-      password = "mypassword123";
-    };
    };
 };
@@ Line 25: / Line 23: @@
 This configuration will automatically set ''msmtp'' as the default mail delivery client on your system by overwriting the <code>sendmail</code> binary. To test mail delivery issue following command:
+<syntaxhighlight lang="console">
+# echo -e "Content-Type: text/plain\r\nSubject: Test\r\n\r\nHello World" | sendmail john.doe@mail.com
+</syntaxhighlight>
+A mail with the subject ''Test'' will be sent to the recipient ''john.doe@mail.com'' including the body text ''Hello World''. A Mime-Header is added to the mail content for better compatibility.
-<code>user</code>
 == Configuration ==
@@ Line 36: / Line 36: @@
 <syntaxhighlight lang="nix">
-programs.msmtp = {
+{
-   enable = true;
+  age.secrets.msmtp = {
-   accounts = {
+    file = "${inputs.self.outPath}/secrets/msmtp.age";
-     default = {
+   };
-       auth = true;
-       tls = true;
+  # for zed enableMail, enable sendmailSetuidWrapper
-       from = "<from address here>";
+  services.mail.sendmailSetuidWrapper.enable = true;
-       host = "<hostname here>";
-       user = "<username here>";
+   programs.msmtp = {
-       passwordeval = "cat /secrets/smtp_password.txt";
+     enable = true;
+    setSendmail = true;
+    defaults = {
+       aliases = "/etc/aliases";
+       port = 587;
+       auth = "plain";
+       tls = "on";
+       tls_starttls = "on";
+    };
+    accounts = {
+       default = {
+        host = "smtp.mail.example.com";
+        passwordeval = "cat ${config.age.secrets.msmtp.path}";
+        user = "myname@example.com";
+        from = "myname@example.com";
+      };
      };
    };
-};
+}
 </syntaxhighlight>
@@ Line 55: / Line 70: @@
 === Aliases ===
-Example:
+Then, configure an alias for root account. With this alias configured, all mails sent to root, such as cron job results and failed sudo login events, will be redirected to the configured email account.
 <syntaxhighlight lang="nix">
-programs.msmtp.defaults = {
+{
-   aliases = "/etc/aliases";
+   environment.etc.aliases.text = ''
-};
+    root: admin@example.com
+  '';
-environment.etc = {
+}
-  "aliases" = {
-    text = ''
-      root: me@example.com
-    '';
-    mode = "0644";
-  };
-};
 </syntaxhighlight>