karatektus /pl_mail
Self-hosted, Gmail-style mail client. Multi-account IMAP, threaded conversations, real-time push via IMAP IDLE + Mercure. Built with Symfony, FrankenPHP, Hotwire Turbo. Clone and docker compose up.
★ 645⑂ 51👁 2⑃ 353● 275▤ 14
645
stars
51
forks
2
watchers
353
prs
275
issues
14
releases
README
plMail Self-hosted mail with a calendar beside it. Connect the mailboxes you already have — IMAP, Gmail, Outlook — and read them side by side in one inbox, on a server you own. !PHP !Symfony !PostgreSQL !License 📖 Read the handbook → Installing on Docker, Linux, WSL2, macOS or a NAS · every feature in detail · connecting Gmail and Outlook, with the exact permissions to tick · how the internals work. Also on the wiki and in docs/ — all three are built from the same files. 📱 Apps for your phone - Android — Google Play (paid, early access), or free from karatektus/pl_mail_android. Buying it on Play is, for now, the main way this project supports itself. - iOS — karatektus/pl_mail_ios Both connect to your own plMail server. --- What it is A mail client you host yourself. It connects to the mailboxes you already have — IMAP, Gmail, Outlook — syncs them into your own PostgreSQL database, and gives them one inbox, one search box and one set of labels in the browser. It is not a mail server: it doesn't receive mail from the internet or host your domain. Because everything is synced locally, search runs against your database, and your mail stays readable when a provider doesn't. !The plMail inbox Highlights - Every account in one place — IMAP, Gmail and Outlook side by side, sending aliases included. Credentials are encrypted before they touch the database. - New mail arrives on its own — IMAP IDLE, Gmail and Outlook push, browser notifications. - Search that means it — full text plus from:, subject:, label:, has:, before: and friends, completed as you type. Every hit shows the words it matched on, marked, in a window of the message around them. What the words found comes first; what the model merely thought looked similar follows, labelled, and never pushes a real match off the page. - Filters as a tree — any/all/none, nested, restated in plain English and counted against real mail before you save. Apply one to mail that arrived before it existed. - Filed where you drop it — drag a conversation onto a folder, a label or one of the inbox tabs, several at once if they are ticked. A folder moves it and a label just adds itself, so dropping on "Receipts" does not take the mail out of your inbox; Starred stars it and Unread — an optional list of every unread conversation, whatever folder it is in — marks it unread, both where it lies. Only the targets that will accept it light up, and a tab you choose by hand stays chosen when the next message in the thread arrives. - A calendar beside the mail — two-way sync with Google, Microsoft and CalDAV, a drag-to-move week grid that pans rather than squeezes on a phone, invitations answered in place and landing in the calendar as you answer them, share and booking links. The time is always in view — on the Happening Soon button, under the name, or at the foot of the sidebar with the next thing coming up. - Files where you keep them — attach from and save to Drive, Photos, One
Top issues
#44Feature Request: Sharing of Email Accounts11 comments · 2026-10-10#601PLmail Container Crashing multiple times during the day.4 comments · 2026-11-13#75Feature request: CalDAV tasks with a toggleable widget below the calendar4 comments · 2026-10-11#594Epic: admins manage users' mailboxes (shared mailboxes, rights, policies) and a separate Dev menu2 comments · 2026-11-12#186Feature: a context menu on sidebar folders with the actions that apply to that folder2 comments · 2026-10-16#615Toggle to Disable Thread Conversation view1 comments · 2026-11-13#566Feature Request: Export application logs and bulk contact/address book management1 comments · 2026-11-11#467Optional: start plMail with Flisk (service.json per container, same volumes, compose.yaml unchanged)1 comments · 2026-11-01
Discussions
#611Content Spotlight on selfh.st3 comments · 2026-11-13#581Worker run since 15H2 comments · 2026-11-12#568Can I enable GMail only for Calendar ?2 comments · 2026-11-11#492Google Photos denied access. The connection may be missing a permission.1 comments · 2026-11-06#475Feature Request – Local Mail Folders and Permanent Email Archiving2 comments · 2026-11-03#465Google Play Store1 comments · 2026-11-01#276Optional MariaDB/MySQL support alongside PostgreSQL1 comments · 2026-10-21#226GitHub Releases1 comments · 2026-10-19
Latest release
v0.4.3 v0.4.3 2026-11-12Image: ghcr.io/karatektus/pl_mail:0.4.3 Settings is now a tree with a search, mailto: links open in plMail's own composer — in a tab or in the installed app, which can also do without its title bar — and an account can be used for its mail, its calendar or its contacts on their own. WebDAV joins the file services, search answers a common word much faster, pages load sooner, and a server on your own network can be allowed from the admin page. Settings is easier to find your way around, and it has a search. The settings column was 29 pages in five groups, sixteen of them under "Mail", and Gen