kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-12-07 18:05:09 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
eca7ffea3613c6b012f4194fdaf1a6dc1b630b0f
computer-playbook/roles/sys-svc-mail-smtp/README.md
Kevin Veen-Birkenbach 8e4ee723d7 Make mail stack optional for Infinito.Nexus deployments without Mailu (e.g. Raspberry Pi / robots) 
Refactored mail-related roles to support running Infinito.Nexus on nodes without a dedicated mail server:
- Introduced sys-svc-mail as central mail orchestration role.
- Split msmtp handling into sys-svc-mail-msmtp.
- Added sys-svc-mail-smtp to provide a localhost-only Postfix relay when Mailu is not present.
- Updated alert/health roles to use the new mail orchestration.
- Avoid installing postfix inside containers via IS_CONTAINER guard.
- Adjusted WordPress role to use the new msmtp template path.

This allows lightweight deployments (e.g. Raspberry Pi, robots, edge nodes) to send mail via localhost without requiring a full Mailu stack.

ChatGPT discussion: https://chatgpt.com/share/6931edf1-cb98-800f-9e3c-a62d69ccb223
2025-12-04 21:24:53 +01:00

2.8 KiB
Raw Blame History

sys-svc-mail-smtp 📮

Description

The sys-svc-mail-smtp role configures a local SMTP relay using Postfix, listening exclusively on localhost.
It is designed to be used as a fallback when no central Mailu instance is available, enabling applications and system services to send email via localhost:25 without additional configuration.

For general background on SMTP, see SMTP on Wikipedia.
For details about Postfix itself, see Postfix on Wikipedia.

Overview

This role:

  • Installs Postfix via pacman on Arch Linux.
  • Configures it as a loopback-only relay, so it:
    • only listens on 127.0.0.1,
    • does not perform local mailbox delivery,
    • and is safe to use as a simple outbound relay for the local host.
  • Integrates seamlessly with the sys-svc-mail and sys-svc-mail-msmtp roles in the Infinito.Nexus stack.

Typically, sys-svc-mail decides whether to:

  • Use Mailu (via sys-svc-mail-msmtp), or
  • Fall back to this role (sys-svc-mail-smtp) and send via localhost.

Purpose

The main goals of this role are:

  • Provide a minimal, secure SMTP relay for hosts that do not run a full mail stack.
  • Enable msmtp (and any other sendmail-compatible client) to send mail by talking to localhost:25.
  • Avoid the complexity of a full MTA configuration while still supporting basic outbound notifications.

This is particularly useful for:

  • Monitoring nodes,
  • Utility hosts,
  • Development or test environments without Mailu.

Features

  • 💾 Postfix Installation on Arch Linux

    • Uses community.general.pacman to install the postfix package.

  • 🔒 Loopback-Only Configuration

    • Configures inet_interfaces = loopback-only to restrict the SMTP daemon to 127.0.0.1.
    • Defines mynetworks = 127.0.0.0/8 for safe local relaying.

  • 🚫 No Local Mailbox Delivery

    • Sets local_transport = error: local delivery disabled to avoid storing mail locally.
    • Focus is purely on relaying from localhost rather than full MTA behavior.

  • 🧩 Integration with Infinito.Nexus

    • Meant to be driven by sys-svc-mail, which decides when to enable this relay.
    • Works hand in hand with sys-svc-mail-msmtp, which configures msmtp to talk to localhost:25 when Mailu is not present.

Further Resources

Reference in New Issue View Git Blame Copy Permalink