Repository navigation
MailFlow v4.5.0
This release adds tags, snippets, outgoing webhooks, a rule action that labels mail in every account, and full-body search for HTML-only and Gmail mail. You can also choose how long you stay signed in. Thanks to @Phenixis for tags, @dcoffin88 for the templates plugin, @faroxdev for webhooks, @Raed-Alghamdi for client certificates on Android, @anhnt256 for the time format setting, @beisenherz for DATABASE_URL, and @salmonumbrella for the folder sync work and the cross-account labels proposal. Thanks also to @shady2k for six detailed proposals on list, search and resume behavior, and to @axiomatose, @rioradio, @computrav, @snuq and @McFlyegy for their reports.
New
- Tags (#598, #763). Create tags with a color under Settings → Categories, then tag a message from its right-click menu. Tags show as pills in the message list. A tag follows the email, so it stays when the message is moved or archived.
- Snippets (#706). Turn on the Templates plugin under Settings → Plugins to save text you send often and insert it from the composer. Snippets can hold variables: dates fill in when inserted, and the recipient's name once the first To address is entered.
- Outgoing webhooks for new mail (#619, #736). Send a notification to ntfy, Gotify or any JSON endpoint when mail arrives. An admin turns them on under Settings → Outgoing webhooks, and can allow private-network addresses there, including VPN addresses such as Tailscale and NetBird. Each user then sets up their own under Settings → Notifications. The sender and subject are sent only if the user chooses, and message bodies never are.
- Apply label, in any rule (#751). A rule can now label mail by name in every account, including an "All accounts" rule. Each account gets a folder with that name the first time it's needed, and on Gmail it's a real Gmail label. The label goes on before the rule moves, archives or deletes anything. If it can't be applied, the message stays in the Inbox and the rule shows why. Run rules on inbox can be used again safely, since mail that's already labeled isn't copied twice.
- Search finds words anywhere in HTML-only mail (#320). Before, a message sent only as HTML could be found only by its subject, sender and first lines.
- Search on Gmail also asks Gmail (#320). MailFlow doesn't download Gmail message bodies in the background, so a message nobody had opened could be found only by its subject and sender. Search now also asks Gmail, and adds its matches to MailFlow's own.
- Stay signed in longer (#400). Under Settings → Security, each user picks 7, 14, 30, 60 or 90 days without use before being signed out.
SESSION_IDLE_DAYS(1 to 365) sets the default for users who haven't picked; it's 7 days unless set. - 12-hour or 24-hour clock (#758, #775), under Settings → Appearance, whatever the interface language.
- AI gateway headers (#746). Settings → AI Assistant takes extra request headers for a gateway in front of the AI provider, such as Cloudflare's
cf-aig-authorization. Their values are stored encrypted and shown masked, like the API key. - The list says when it is catching up (#748). After the app wakes from sleep, a slim strip says "Updating…" if reloading the list takes more than a second. If the reload fails, it says so and offers Retry.
- Client certificates on Android (#603, #764). The Android app can connect to a server that requires a client certificate (mutual TLS).
DATABASE_URL(#770, #778). The backend can connect with a single connection URL, including parameters such assslmode.
Fixes
- The account's unread badge changes only for Inbox mail. Reading or moving unread mail in another folder no longer drops the badge for up to 15 seconds (#747).
- The select-all box says what it selects ("Select this page" or "Select loaded messages"), and shows a mixed state when only some are selected (#741).
- In paginated mode, search results have a Load more button. While a new search runs, the previous results are dimmed. A failed Load more says so and offers Retry (#742).
- Load more disappears once the list has no more mail. A page emptied by deleting or moving mail moves back to the last page. A list scrolled past 500 messages no longer jumps back on a refresh (#743).
- The AI connection works with providers that redirect within their own API, such as The Grid. A redirect elsewhere still fails, and the error now names the address (#401).
- The Android app explains a host it can't load, for example "Certificate not trusted", instead of showing a blank screen. It asks to update Android System WebView when that is too old (#776). The Android and desktop apps allow plain HTTP to Tailscale addresses (100.64.0.0/10), after the usual warning.
- Opening the app makes fewer round trips before the inbox shows, so a cold start on a phone is faster.
- Copying mail into a folder and that folder's sync no longer get in each other's way, so copies and labels stay in step with the server (#759, #760).
- Creating a nested folder that already exists finds its real path on servers that use
.as the separator.
Upgrading
Update as usual. Nobody is signed out this time. Migrations 0078 to 0081 run automatically.
Search index: after the first start, a background job indexes the HTML-only mail already stored, so search can find words in it. On a large mailbox this takes a few minutes; MailFlow works normally meanwhile.
Pre-built images (Option A):
docker compose pull
docker compose up -dTo use SESSION_IDLE_DAYS or DATABASE_URL, download the new docker-compose.ghcr.yml first. Without it, those settings never reach the backend.
Built from source (Option B): git pull, then docker compose up -d --build.
Webhooks are off until an admin turns them on under Settings → Outgoing webhooks.
SESSION_IDLE_DAYS is a default, not a limit: users can still pick up to 90 days under Settings → Security.
ghcr.io/maathimself/mailflow-backend:latest points at 4.5.0, published for amd64 and arm64.
MailFlow is built and maintained by one person. If it's useful to you, you can support it on GitHub Sponsors or Ko-fi. Using MailFlow in a business? A business license supports development too. Thank you to everyone who already does.