karatektus / pl_mail

# 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.
### 📖 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** — karatektus/pl_mail_android
- **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.
## 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, OneDrive, Dropbox,
 Nextcloud, Immich and Paperless-ngx.
- **A language model, if you want one** — point plMail at an Ollama box on y