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
PHPAGPL-3.0Created 2026-07-02
Download: v0.4.3v0.4.3 ↓0.4.32026-11-12
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

Discussions

Latest release

v0.4.3 v0.4.3 2026-11-12
Image: 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON