📬 post. — a calmer inbox
Ich entwickle post. immer weiter und dementsprechend aktualisiere ich die ReadMe ständig.
🐳 Docker · 🗄️ SQLite · 🌗 Light & Dark Mode · 🇩🇪 Deutsch · 🇬🇧 English
Deutsch
Dein Postfach. Dein Platz.
Modernes Webmail mit einer blauen Oberfläche, flexiblen Ansichten und einer einfachen Anmeldung.
✨ Funktionen
| Bereich | Funktionen |
|---|
| 🔐 Anmeldung | Eigenes post.-Konto mit Registrierung und Administrator-Freischaltung; Mailverbindung optional per OAuth2 oder App-Passwort |
| 👥 Mehrbenutzer | Administrator-/Benutzerrollen, Gruppen und Berechtigungen für Mail, Kalender und Dateien |
| 🤝 Freigaben | Private Dateien/Ordner für Benutzer und Gruppen; geerbte Lese-, Bearbeitungs- und Löschrechte |
| 📬 Postfach | Listenansicht, Lesebereich unten oder rechts; seitenweiser Abruf und getrennte Hintergrundprüfung |
| ↔️ Oberfläche | Verschiebbare Ordnerleiste, Lesebereiche und Spalten |
| 🌗 Darstellung | Heller und dunkler Modus |
| 🎨 Theme-Editor | Eigene Farben für Hell/Dunkel, vier Farbvorlagen, lokale Schriftarten und skalierbare Schriftgröße; Vorschau und Zurücksetzen |
| 🔍 Suche | Ordnerübergreifende Suche mit animierter Suchanzeige |
| ✍️ Nachrichten | HTML/Klartext, Antworten, Weiterleiten, Cc/Bcc und Anhänge |
| 📁 Ordner | Hierarchie, Unterordner, Erstellen, Löschen und Sichtbarkeit |
| 🗂️ Archiv | Frei wählbarer Archivordner und verschiedene Ablagestrukturen |
| 👥 Kontakte | Adressbücher, Gruppen, Kontaktbilder und erweiterte Kontaktinformationen |
| 📅 Kalender | Persönliche SQLite-Kalender, CalDAV, Google/Microsoft-Anbindung, ICS, Monats-/Wochen-/Terminansicht; Tagesfeld anklicken und Termine im Popup erstellen/bearbeiten |
| 📁 Dateien | Privater verschlüsselter Dateispeicher, Google Drive und OneDrive; Datei-/Ordner-Upload, Drag & Drop, Ordner, Downloads, Umbenennen, Verschieben, Papierkorb, Vorschau, Listen-/Kachelansicht |
| 📝 Dokumente | Optional: ONLYOFFICE-Vorschau und Bearbeitung für PDF, DOCX, XLSX und PPTX; Zurückspeichern in privaten Speicher, Google Drive oder OneDrive |
| 📥 Import | Google-/Outlook-CSV, einschließlich Kontakten ohne E-Mail-Adresse |
| 📤 Export | Kontakte als CSV/vCard; Nachrichten als EML |
| 🩺 Diagnose | Mail-Ladezeiten, Fehlercodes und einzelne Abrufschritte pro Benutzer; Filter und JSON-Download |
| ⚙️ Einstellungen | Sprache, Darstellung, Identität, Signatur, Spezialordner und Benachrichtigungen |
👥 Neu in Version 2.0
Eigene Benutzeranmeldung, Registrierung, Administratorverwaltung und Dateifreigaben sind in MULTIUSER.md beschrieben. Beim ersten Start den einmaligen Einrichtungscode mit docker compose exec backend cat /app/data/admin-setup-token auslesen; in Portainer die Backend-Konsole verwenden. Bestehende Installationen vor dem Update sichern und zuerst das bisherige Mailkonto verbinden, bevor neue Daten angelegt werden.
⚡ Mailabruf und Fehlerdiagnose
Ab Version 1.6.0 lassen sich Mail-Anhänge neben dem Herunterladen auch direkt in Dateien speichern: im privaten Speicher oder in einem verbundenen Google Drive/OneDrive, jeweils mit Zielordner und bearbeitbarem Dateinamen. Bei Namenskonflikten gibt es eine Kopie mit neuem Namen oder bewusstes Ersetzen, wenn die Datei sicher ersetzbar ist. Details stehen in FILES.md.
Ab Version 1.5.5 wird bei einer nicht mehr verfügbaren Nachricht die Mail-Liste automatisch frisch vom Server geladen. Die Nachricht wird geschlossen und ein verständlicher Hinweis angezeigt. Schlägt die Aktualisierung fehl, bleibt der Fehler mit einer Wiederholungsmöglichkeit sichtbar.
Ab Version 1.5.4 bleiben ungenutzte IMAP-Verbindungen fünf Minuten erhalten. Dadurch können auch Prüfungen im Zwei-Minuten-Abstand die bestehende Verbindung wiederverwenden. Die Diagnose zeigt Netzwerkaufbau und Serverbegrüßung/Anmeldung getrennt; Details stehen in PERFORMANCE.md.
Ab Version 1.5.3 können direkte Mailabrufe eine freie Hintergrundverbindung desselben Postfachs übernehmen. Ein Listenabruf ohne wartende Browseraufrufe wird abgebrochen, damit der nächste Abruf keinen alten Timeout übernimmt. Bereits laufende Hintergrundaufträge und andere wartende Browseraufrufe bleiben getrennt geschützt.
Unter Einstellungen → Diagnose findest du seit Version 1.5.2 Ladezeiten, Fehlercodes, Anfrage-IDs und die einzelnen Schritte des Mailabrufs. Mit Protokoll herunterladen kannst du die Einträge als JSON sichern. Pro Postfach werden bis zu 1000 Einträge für sieben Tage in der bestehenden SQLite-Datenbank aufbewahrt; die Aufzeichnung beginnt mit diesem Update. Passwörter, Tokens, Mail-Inhalte, Betreffzeilen, Suchbegriffe und Ordnernamen werden nicht aufgenommen. Es werden keine Daten automatisch an einen externen Diagnosedienst versendet.
Die normale Mail-Liste lädt nur die benötigte Seite. Hintergrundprüfungen verwenden eine getrennte Verbindung. Bei ausgeschalteter Prüfung aller Ordner wird nur der Posteingang im Hintergrund geprüft; andere Ordnerzähler aktualisieren sich beim Öffnen. Fehler bleiben mit aufklappbaren Details sichtbar. Hinweise zu Zeitgrenzen, großen Anhängen und Diagnose: PERFORMANCE.md.
🧭 Welche Variante passt zu deinem Server?
| Variante | Stack-Datei | Enthalten |
|---|
| 📬 Webmail ohne ONLYOFFICE | docker-compose.yml | E-Mail, Kontakte, Kalender und Dateien; eigene Bild-/Textvorschau, Office-Dateien herunterladen |
| 📝 Webmail mit ONLYOFFICE | docker-compose.onlyoffice.yml | Alles aus der Standardvariante plus Dokumentvorschau und Bearbeitung mit zusätzlichem ONLYOFFICE-Container |
Eine der beiden vollständigen Stack-Dateien verwenden. Die ONLYOFFICE-Datei enthält bereits Frontend und Backend; dafür keinen zweiten Webmail-Stack anlegen und die Dateien nicht zusammenführen.
Bei wenig freiem RAM die Standardvariante wählen. ONLYOFFICE nennt mindestens 4 GB RAM für seine Docker-Installation; Betriebssystem, Webmail und weitere Dienste benötigen zusätzlich Speicher. Für einen gemeinsamen Server sind 8 GB oder mehr eine praktische Empfehlung, abhängig von Dokumentgröße und gleichzeitiger Nutzung. Die Standardvariante benötigt keinen Dokumentserver und kann später erweitert werden. ONLYOFFICE-Systemanforderungen.
🚀 Installation mit Docker Compose
Die optionale Kalenderanbindung und OAuth-Einrichtung sind in CALENDAR.md beschrieben. Client-ID und Client-Secret für Google/Microsoft können direkt über Kalender → Kalender hinzufügen → Kalender verbinden eingegeben werden. Google benötigt dafür eine HTTPS-Domain. Der persönliche Kalender funktioniert ohne zusätzliche Konfiguration.
Der Bereich Dateien bietet sofort einen privaten Speicher auf deinem Server. Optional kannst du über Dateien → Cloud hinzufügen Google Drive oder OneDrive verbinden. Dafür die zusätzlichen Datei-Berechtigungen und Rücksprungadressen beim Anbieter einrichten; die Kalenderverbindung bleibt getrennt. Anleitung, Speichergrenzen und Proxy-Hinweise stehen in FILES.md. Standard: 1 GB pro Datei und 5 GB privater Speicher pro Benutzer. Lokale Dateiinhalte werden verschlüsselt im bestehenden Datenvolume gespeichert; Dateinamen und Metadaten liegen in SQLite.
Voraussetzungen:
- Docker mit Docker Compose und Linux-Containern
- Für den öffentlichen Zugriff eine HTTPS-Domain, z. B. über Nginx Proxy Manager
- Nur für die optionale Mailverbindung: IMAP und OAuth2 oder Mail-/App-Passwort beim Anbieter
Die Datei docker-compose.yml herunterladen und in ihrem Verzeichnis ausführen:
docker compose up -d
Anschließend im Browser öffnen:
http://SERVER-IP:8886
Auf dem eigenen Rechner:
http://localhost:8886
Datenbank und Verschlüsselungsschlüssel werden beim ersten Start automatisch angelegt.
🧩 Installation über Portainer
Für eine Docker-Standalone-Umgebung:
- Stacks → Add stack → Web editor öffnen.
- Einen Stack-Namen vergeben, beispielsweise
post-webmail.
- Den Inhalt der docker-compose.yml einfügen.
- Bei Bedarf die unten beschriebenen Umgebungsvariablen ergänzen.
- Deploy the stack auswählen.
Danach die Webmail unter http://SERVER-IP:8886 öffnen.
📝 Installation mit ONLYOFFICE
Die Webmail-Images müssen die ONLYOFFICE-Einbindung enthalten (ab v1.4.0). Für eine neue Installation die vollständige docker-compose.onlyoffice.yml verwenden. Eine vorhandene Installation im gleichen Projekt bzw. bestehenden Portainer-Stack erweitern und das vorhandene Datenvolume beibehalten.
- Auf dem Server mit
openssl rand -hex 32 einen zufälligen Schlüssel erzeugen.
- Eine eigene Office-Subdomain anlegen, z. B.
office.example.com. Im Nginx Proxy Manager auf HTTP → Docker-Server-IP → Port 8888 weiterleiten, Websockets Support aktivieren und ein gültiges SSL-Zertifikat mit Force SSL einrichten. Bei anderem ONLYOFFICE_PORT den Proxy-Port entsprechend ändern. Die Webmail behält ihre eigene Adresse und ihren bisherigen Port.
- Die folgenden Variablen in der
.env bzw. unter Environment variables des Portainer-Stacks setzen:
WEBMAIL_VERSION=2.0.0
WEBMAIL_PORT=8886
ONLYOFFICE_URL=https://office.example.com
ONLYOFFICE_JWT_SECRET=HIER_DEN_ERZEUGTEN_SCHLUESSEL_EINTRAGEN
ONLYOFFICE_PORT=8888
ONLYOFFICE_VERSION=9.4.0.1
ONLYOFFICE_MAX_FILE_MB=50
Domain und Schlüssel ersetzen; eigene Ports und die gewünschte verfügbare Webmail-Version beibehalten. latest ist ebenfalls möglich. Der Office-Port muss frei sein. Den Schlüssel nicht veröffentlichen.
Docker Compose: Aus dem bisherigen Projektverzeichnis starten:
docker compose -f docker-compose.onlyoffice.yml up -d
Portainer: Im bestehenden Stack unter Editor die vollständige docker-compose.onlyoffice.yml einsetzen, vorhandene Daten-/Port-/OAuth-Einstellungen behalten und Update the stack → Re-pull image and redeploy wählen. Bei einer Neuinstallation diese Datei bereits beim Anlegen des Stacks verwenden.
Die optionale Stack-Datei setzt automatisch ONLYOFFICE_ENABLED=true, ONLYOFFICE_INTERNAL_URL=http://onlyoffice und ONLYOFFICE_CALLBACK_BASE_URL=http://backend:3000. Diese drei Werte müssen dafür nicht in der .env eingetragen werden. Nur ONLYOFFICE_ENABLED=true in der normalen Datei startet noch keinen Dokumentserver.
Nach dem ersten Start einige Minuten warten, die Webmail mit STRG + F5 neu laden und unter Dateien eine PDF-, DOCX-, XLSX- oder PPTX-Datei öffnen. Bearbeiten wählen, eine kleine Änderung speichern, die Vorschau schließen und die Datei erneut öffnen. Änderungen werden in dieselbe Datei im privaten Speicher, Google Drive oder OneDrive zurückgeschrieben. Native Google-Dokumente weiterhin beim Anbieter bearbeiten; Bilder und Text behalten ihre eigene Vorschau.
ONLYOFFICE verarbeitet die Dokumente entschlüsselt und kann sie in seinen eigenen Cache-Volumes halten. Auch diese Volumes und Backups schützen. Einrichtung, Speichergrenzen und Wiederherstellung erklärt ONLYOFFICE.md.
Zur Standardvariante zurückkehren: Laufende Bearbeitungen erst speichern und schließen. ONLYOFFICE_ENABLED=false setzen und im selben Stack wieder die vollständige normale Compose-Datei verwenden. In Portainer beim Update den entfernten ONLYOFFICE-Dienst ebenfalls entfernen lassen. Bei Docker Compose:
docker compose -f docker-compose.onlyoffice.yml stop onlyoffice
docker compose -f docker-compose.yml up -d --remove-orphans
Damit läuft kein zusätzlicher Dokumentserver mehr. Die benannten Datenvolumes bleiben erhalten; --remove-orphans entfernt im gleichen Compose-Projekt die Container von Diensten, die nicht mehr in der gewählten Datei stehen.
⚙️ Alle Variablen der .env
Für Docker Compose die .env.example als .env neben der gewählten Compose-Datei speichern und anpassen. In Portainer dieselben Werte unter den Environment variables des Stacks eintragen. Nicht jede Variable muss befüllt werden; die Standardvariante funktioniert ohne OAuth-/Office-Zugangsdaten. Die .env mit echten Schlüsseln und Secrets nicht veröffentlichen.
Webmail und privater Dateispeicher
| Variable | Bedeutung | Standard |
|---|
DOCKERHUB_NAMESPACE | Namensraum der bereitgestellten Webmail-Images; normalerweise beibehalten | paquele |
WEBMAIL_VERSION | Image-Version für Frontend und Backend; z. B. 2.0.0 oder latest | latest |
WEBMAIL_PORT | Freier Port auf dem Docker-Host für die Webmail | 8886 |
WEBMAIL_DATA_DIR | Optionaler Host-Datenordner statt des benannten Volumes; enthält Datenbank, Schlüssel und lokale Dateien | Docker-Volume webmail_data |
FILES_MAX_UPLOAD_MB | Maximale Größe einer einzelnen hochgeladenen Datei in MiB; unabhängig vom Office-Limit | 1024 (1 GiB) |
FILES_QUOTA_MB | Private Speicherquote pro Benutzer in MiB; Papierkorb und verschlüsselte Cloud-/Office-Arbeitskopien zählen mit | 5120 (5 GiB) |
Ein eigener Host-Datenordner muss für den Backend-Benutzer mit UID 1000 schreibbar sein. Bei einem Update dieselbe Datenablage und denselben Compose-Projektnamen beibehalten. Größen als positive ganze Zahlen angeben; 1024 MiB = 1 GiB. Für temporäre Arbeitskopien Platz innerhalb der Quote lassen.
Kalender und Cloud-Verbindungen: optionale Servervorgaben
Du kannst die OAuth-Daten direkt beim Verbinden in der Webmail eingeben. Dann dürfen die folgenden Servervorgaben leer bleiben bzw. fehlen. Die über die Oberfläche gespeicherten Einstellungen gelten pro Benutzer und haben Vorrang vor den Servervorgaben. Eine Dateiverbindung ohne eigene OAuth-Konfiguration kann die Kalenderkonfiguration desselben Anbieters übernehmen; die Berechtigungen und Anmeldungen für Kalender und Dateien bleiben getrennt.
| Variable | Bedeutung | Standard |
|---|
PUBLIC_BASE_URL | Öffentliche HTTPS-Adresse der Webmail, z. B. https://post.example.com, ohne Unterpfad; Grundlage der OAuth-Rücksprungadressen, wenn Servervorgaben verwendet werden | leer |
GOOGLE_CLIENT_ID | Optionale Google-OAuth-Client-ID als Vorgabe für Mail/Kalender/Drive | leer |
GOOGLE_CLIENT_SECRET | Zugehöriges Google-Client-Secret; kein Mail-/App-Passwort | leer |
MICROSOFT_CLIENT_ID | Optionale Microsoft-OAuth-Anwendungs-ID als Vorgabe für Mail/Kalender/OneDrive | leer |
MICROSOFT_CLIENT_SECRET | Zugehöriger Microsoft-Client-Secret-Wert | leer |
MICROSOFT_TENANT_ID | Microsoft-Verzeichnis bzw. Mandant für die Servervorgabe; eine konkrete Tenant-ID ist ebenfalls möglich | common |
ALLOW_PRIVATE_CALDAV | true erlaubt zusätzlich CalDAV-Verbindungen zu privaten/internen Serveradressen; nur bei Bedarf aktivieren | false |
Wenn du Servervorgaben nutzt, für den jeweiligen Anbieter auch PUBLIC_BASE_URL und beide Client-Zugangsdaten setzen. Bei Einrichtung über die Oberfläche dort die Webmail-Adresse und Zugangsdaten angeben. OAuth-Daten werden verschlüsselt in SQLite gespeichert. Lokale Kalender und privater Dateispeicher brauchen keine OAuth-App. Anbieter-Konfiguration, Berechtigungen und genaue Callback-Adressen stehen in CALENDAR.md und FILES.md.
ONLYOFFICE
| Variable | Bedeutung | Standard / Verhalten |
|---|
ONLYOFFICE_ENABLED | Aktiviert die Office-Einbindung im Backend; startet selbst keinen Container | false in der normalen Datei; in der optionalen Datei fest true |
ONLYOFFICE_URL | Öffentliche HTTPS-Adresse des Dokumentservers, z. B. https://office.example.com; vom Browser erreichbar, ohne Unterpfad | leer; für ONLYOFFICE erforderlich |
ONLYOFFICE_INTERNAL_URL | Adresse, unter der unser Backend den Dokumentserver intern erreicht | normale Datei: Office-URL als Fallback; optionale Datei: fest http://onlyoffice |
ONLYOFFICE_CALLBACK_BASE_URL | Adresse unseres Webmail-Backends, unter der ONLYOFFICE Dokumente abruft und Speicher-Callbacks sendet; nicht die Office-Subdomain | normale Datei: PUBLIC_BASE_URL als Fallback; optionale Datei: fest http://backend:3000 |
ONLYOFFICE_JWT_SECRET | Gemeinsamer zufälliger Schlüssel für Webmail-Backend und ONLYOFFICE, mindestens 32 Zeichen; openssl rand -hex 32 erzeugt ihn | leer; für ONLYOFFICE erforderlich |
ONLYOFFICE_MAX_FILE_MB | Maximale Dokumentgröße für Vorschau/Bearbeitung in MiB, ganze Zahl von 1 bis 100; normale Uploads können größer sein | 50 |
ONLYOFFICE_VERSION | Version des separaten ONLYOFFICE-Images, unabhängig von WEBMAIL_VERSION; nur die optionale Datei verwendet sie | 9.4.0.1 |
ONLYOFFICE_PORT | Freier Host-Port des Dokumentservers; Zielport im Nginx Proxy Manager | 8888; nur die optionale Datei verwendet ihn |
Die optionale Datei überschreibt die drei Werte ENABLED, INTERNAL_URL und CALLBACK_BASE_URL fest. Die entsprechenden Einträge in .env werden dabei nicht verwendet. Ein vorhandener externer Dokumentserver kann stattdessen mit der normalen Datei und passenden Office-Variablen eingebunden werden.
🔐 Anmeldung
Melde dich mit deinem eigenen post.-Benutzerkonto und post.-Passwort an. Neue Benutzer können sich registrieren und werden durch einen Administrator freigeschaltet. Für die erste Einrichtung wird der Code aus dem Backend-Datenvolume benötigt; siehe MULTIUSER.md.
Unter Einstellungen → Konto & Verbindungen anschließend Google oder Microsoft per OAuth2 verbinden. Bei anderen Anbietern werden IMAP und SMTP automatisch erkannt und die Verbindung mit dem Mail-/App-Passwort geprüft. Auch ohne Mailkonto stehen Kontakte, Kalender und Dateien zur Verfügung. Persönliche Verbindungen und Daten bleiben dem jeweiligen Benutzer zugeordnet.
🖥️ Dein Postfach, deine Ansicht
Wähle zwischen drei Ansichten:
| Ansicht | Beschreibung |
|---|
| 📋 Liste | Nachrichtenliste; Nachrichten öffnen im Arbeitsbereich |
| ⬇️ Lesebereich unten | Nachrichtenliste oben, Vorschau darunter |
| ➡️ Lesebereich rechts | Nachrichtenliste links, Vorschau daneben |
Weitere Möglichkeiten:
- Breite der Ordnerleiste verändern
- Größe des Lesebereichs verändern
- Spalten per Drag-and-drop umsortieren
- Spaltenbreiten anpassen
- Anzahl der Nachrichten pro Seite einstellen
- Zwischen heller und dunkler Darstellung wechseln
⌨️ Mehrfachauswahl
| Bedienung | Funktion |
|---|
STRG / CMD + Klick | Einzelne Nachrichten auswählen oder abwählen |
SHIFT + Klick | Zusammenhängenden Bereich auswählen |
STRG + SHIFT + Klick | Bereich zur bestehenden Auswahl hinzufügen |
Das Auswahlmenü bietet Alle, Keine, Gelesene und Ungelesene für die aktuelle Seite.
💌 Nachrichten
- Neue Nachrichten schreiben
- Antworten und allen antworten
- Nachrichten weiterleiten
- HTML- und Klartextnachrichten erstellen
- Empfänger, Cc und Bcc verwenden
- Anhänge bis insgesamt 20 MB hinzufügen
- Empfangene Anhänge herunterladen
- Nachrichten als gelesen oder ungelesen markieren
- Sterne setzen
- Nachrichten verschieben, archivieren oder als Spam ablegen
- Nachrichten als EML exportieren
- Quelltext anzeigen
- Nachrichten drucken
Das Löschen verschiebt Nachrichten normalerweise in den Papierkorb. Endgültiges Löschen erfordert eine Bestätigung.
✍️ Nachrichtenerstellung und Signatur
- Persönlicher Absendername und Antwortadresse
- Individuelle Signatur
- Einstellbare Schrift und Schriftgröße für HTML-Nachrichten
- Antwort oberhalb oder unterhalb der Originalnachricht
- Einstellbare Signaturposition
- Weiterleitung als eingebetteter Text oder EML-Anhang
- Automatische Umwandlung von URLs in Links
- Rechtschreibprüfung mit Browserunterstützung
- Optionen für Lese- und Zustellbestätigungen
- Automatische Entwurfsspeicherung
Anhänge werden derzeit nicht dauerhaft mit Entwürfen gespeichert. Nach erneutem Öffnen eines Entwurfs gegebenenfalls wieder anhängen.
🔍 Suche in allen Ordnern
Die Suche durchsucht alle auswählbaren Ordner, einschließlich ausgeblendeter Ordner.
Verfügbare Suchfelder:
- Alle — einschließlich Nachrichtentext
- Betreff
- Von
- An
Eine animierte Anzeige zeigt, dass die Suche läuft. Ergebnisse werden seitenweise angezeigt.
Die Suchdauer hängt von der Postfachgröße und der Geschwindigkeit des Mailservers ab.
📁 Ordner und Archiv
- Aufklappbare Ordnerhierarchie
- Ordner ein- und ausblenden
- Eigene Ordner und Unterordner erstellen
- Übergeordneten Ordner im Erstellungsdialog auswählen
- Eigene Ordner nach Bestätigung löschen
- Spezialordner individuell zuordnen
Beim Löschen eines Ordners werden auch dessen Nachrichten und Unterordner entfernt. Systemordner sind geschützt.
Für das Archiv stehen verschiedene Strukturen zur Verfügung:
- Ohne Unterteilung
- Nach Jahr oder Monat
- Monat im Thunderbird-Format
- Nach Absender-E-Mail-Adresse
- Nach Originalordner
- Jahr und Originalordner
- Jahr, Monat und Originalordner
Ist noch kein Archivordner eingestellt, erscheint bei der ersten Verwendung ein Auswahldialog.
👥 Kontakte und Adressbücher
Die Kontaktansicht besteht aus drei Bereichen:
Adressbücher und Gruppen → Kontaktliste → Kontaktdetails
- Eigene Adressbücher erstellen und löschen
- Kontakte anlegen, bearbeiten und löschen
- Kontakte zwischen Adressbüchern verschieben
- Kontakte in Gruppen organisieren
- Standardadressbuch auswählen
- Kontakte suchen, sortieren und drucken
- Kontakte als CSV oder vCard exportieren
- E-Mails direkt an einen Kontakt schreiben
Das persönliche Standardadressbuch bleibt erhalten. Beim Löschen eines Adressbuchs werden dessen Kontakte nach Bestätigung entfernt. Das Löschen einer Gruppe entfernt nur die Gruppenzuordnung.
Kontaktinformationen:
- Vorname, weitere Vornamen und Nachname
- Titel und Namenszusatz
- Mehrere E-Mail-Adressen
- Mehrere Telefonnummern mit Typ
- Mehrere Anschriften
- Firma, Abteilung und Position
- Geburtstag und weitere persönliche Informationen
- Notizen und zusätzliche Felder
- Kontaktbild als PNG, JPEG oder WebP bis 500 KB
Kontakte ohne E-Mail-Adresse werden ebenfalls unterstützt.
📥 CSV-Import aus Google und Outlook
Unter Kontakte → CSV importieren:
- CSV-Datei auswählen.
- Vorschau und erkannte Kontaktanzahl prüfen.
- Zieladressbuch auswählen.
- Duplikatbehandlung festlegen.
- Import starten.
| Eigenschaft | Unterstützung |
|---|
| Trennzeichen | Komma, Semikolon und Tabulator |
| Zeichencodierung | UTF-8, UTF-16 und Windows-1252 |
| Besondere Inhalte | Zitierte Felder und mehrzeilige Notizen |
| Maximale Dateigröße | 10 MB |
| Maximale Kontaktanzahl | 10.000 pro Import |
Kontakte ohne E-Mail-Adresse werden übernommen. Personen mit derselben E-Mail-Adresse bleiben getrennte Kontakte.
Die Option „Identische Kontakte überspringen“ verhindert den erneuten Import vollständig identischer Datensätze.
Nicht zugeordnete Angaben und ungültige E-Mail-Werte bleiben bei ansonsten gültigen Kontakten als Zusatzfelder erhalten.
⚙️ Einstellungen
| Bereich | Möglichkeiten |
|---|
| 🖥️ Benutzeroberfläche | Sprache, Zeitzone, Zeit- und Datumsformat, kurze Datumsanzeige |
| 🎨 Theme-Editor | Farben für Hell/Dunkel, Schriftart, Schriftgröße, Vorschau und Zurücksetzen |
| 📬 Postfachansicht | Layout, Seitengröße und Zeitpunkt der Lesemarkierung |
| 🔔 Benachrichtigungen | Hinweise in der Webmail, Desktop-Mitteilungen und Ton |
| 👁️ Nachrichtendarstellung | HTML/Klartext, externe Bilder, Emoticons und lange Zitate |
| ✍️ Nachrichtenerstellung | Formatierung, Entwurfsspeicherung, Antwort- und Signaturregeln |
| 👥 Kontakte | Standardadressbuch, Anzeige, Sortierung und Autovervollständigung |
| 📁 Spezialordner | Entwürfe, Gesendet, Spam, Papierkorb und Archiv |
| 🗂️ Archiv | Aufteilung und Ablagestruktur |
| 🛠️ Serververhalten | Löschen, Lesemarkierung und Bereinigung beim Abmelden |
| 👤 Absenderidentität | Anzeigename, Antwortadresse und Signatur |
🎨 Dein eigenes Theme
Unter Einstellungen → Theme-Editor kannst du die Oberfläche anpassen:
- Farben: Akzent, Hintergrund, Flächen und Text; heller und dunkler Modus haben eigene Farben.
- Vorlagen: Blau, Lavendel, Mint oder Rosé als Ausgangspunkt wählen.
- Schrift: Standard/System, Arial, Verdana, Georgia oder Monospace; verwendet werden lokal verfügbare Schriften bzw. passende Ersatzschriften.
- Größe: 14–20 px als Basis; Überschriften, Listen und Beschriftungen werden proportional skaliert.
- Vorschau: Änderungen erscheinen sofort. Erst Speichern übernimmt sie dauerhaft; Verlassen der Einstellungen ohne Speichern verwirft die Vorschau.
- Zurücksetzen: Standard wiederherstellen setzt beide Farbmodi und die Schrift zurück. Danach speichern, um den Standard dauerhaft zu übernehmen.
Das Theme wird pro Benutzer in SQLite gespeichert und bei der Anmeldung auf anderen Geräten geladen. In der Demo bleibt es lokal im Browser. Bei wenig Textkontrast bietet der Editor eine passende Textfarbe an. HTML-Mails und ONLYOFFICE-Dokumente behalten ihre eigene Formatierung. Für den Theme-Editor sind keine zusätzlichen Container, .env-Variablen oder Schrift-Downloads nötig.
🖼️ Externe Bilder
Für externe Bilder stehen drei Einstellungen zur Verfügung:
- Fragen: Bilder zunächst blockieren und bei Bedarf laden.
- Immer: Externe Bilder automatisch laden.
- Nie: Externe Bilder blockieren.
Aktive Inhalte und externe Stylesheets bleiben blockiert.
Das Laden externer Bilder kann für den Absender erkennbar sein.
🔔 Benachrichtigungen
Hinweise in der Webmail, Desktop-Mitteilungen und Benachrichtigungston sind getrennt einstellbar.
Desktop-Mitteilungen benötigen eine Browserfreigabe. Die Webmail muss geöffnet bleiben; Browser können Prüfintervalle in Hintergrund-Tabs verzögern.
🗄️ Speicherung und Sicherheit
E-Mails und ihre Ordner bleiben auf dem IMAP-Server.
SQLite speichert unter anderem:
- Konten und verschlüsselte Zugangsdaten
- Benutzereinstellungen
- Adressbücher, Kontakte und Gruppen
- Entwürfe und Bestätigungsprotokolle
Die Anwendungsdaten werden persistent gespeichert. Datenbank und secret.key bei Sicherungen gemeinsam aufbewahren.
Zugangsdaten werden mit AES-256-GCM verschlüsselt. Mailserver-Verbindungen verwenden TLS. HTML-Nachrichten werden bereinigt und isoliert dargestellt.
Für Zugriff über das Internet HTTPS über einen Reverse-Proxy verwenden. Das Compose-Setup selbst liefert HTTP.
🎨 Demo
Über „Demo ansehen“ auf der Anmeldeseite lässt sich die Oberfläche mit Beispieldaten ausprobieren.
Die Demo verbindet sich mit keinem Mailserver und versendet keine Nachrichten.
English
Your inbox. Your space.
Modern webmail with a blue interface, flexible layouts and a simple sign-in experience.
✨ Features
| Area | Features |
|---|
| 🔐 Sign-in | Separate post. account, registration and administrator approval; optional mailbox via OAuth2 or app password |
| 👥 Multiple users | Administrator/user roles, groups and mail/calendar/file permissions |
| 🤝 Sharing | Private files/folders shared with users/groups; inherited view, edit and delete rights |
| 📬 Mailbox | List view, bottom or right reading pane; page-sized fetching and separate background checks |
| ↔️ Interface | Resizable folder sidebar, reading panes and columns |
| 🌗 Appearance | Light and dark mode |
| 🎨 Theme editor | Separate light/dark colors, four presets, local fonts and adjustable font size; live preview and reset |
| 🔍 Search | Cross-folder search with an animated progress indicator |
| ✍️ Messages | HTML/plain text, replies, forwarding, Cc/Bcc and attachments |
| 📁 Folders | Hierarchy, subfolders, creation, deletion and visibility |
| 🗂️ Archive | Configurable archive folder and filing structures |
| 👥 Contacts | Address books, groups, contact pictures and detailed profiles |
| 📅 Calendars | Personal SQLite calendars, CalDAV, Google/Microsoft connections, ICS, month/week/agenda views; click a day cell to create or edit events in a popup |
| 📁 Files | Encrypted private storage, Google Drive and OneDrive; file/folder uploads, drag and drop, folders, downloads, rename, move, trash, previews and list/grid views; compact toolbar in the page header |
| 📝 Documents | Optional ONLYOFFICE viewing/editing for PDF, DOCX, XLSX and PPTX; save back to private storage, Google Drive or OneDrive |
| 📥 Import | Google/Outlook CSV, including contacts without email addresses |
| 📤 Export | Contacts as CSV/vCard; messages as EML |
| 🩺 Diagnostics | Mail request timings, error codes and loading steps per user; filters and JSON export |
| ⚙️ Settings | Language, appearance, identity, signature, special folders and notifications |
👥 New in version 2.0
Separate user sign-in, registration, administration and file sharing are documented in MULTIUSER.md. On first startup, read the setup code with docker compose exec backend cat /app/data/admin-setup-token, or use the backend console in Portainer. Back up existing installations before upgrading and reconnect the previous mailbox before creating new data.
⚡ Mail loading and diagnostics
Since version 1.6.0, mail attachments can also be saved directly to Files: private storage or a connected Google Drive/OneDrive, with a destination folder and editable file name. Name conflicts offer a renamed copy or explicit replacement when supported safely. See FILES.md.
Since version 1.5.5, a message that is no longer available is closed and its list is automatically refreshed from the server. A clear notice explains what happened; failed refreshes remain visible with a retry option.
Since version 1.5.4, idle IMAP connections remain available for five minutes, allowing two-minute polling to reuse them. Diagnostics separates transport setup from server greeting/sign-in; see PERFORMANCE.md.
Since version 1.5.3, interactive mail reads can take ownership of an idle background connection for the same mailbox. Abandoned list reads are cancelled when no callers remain, so later reads do not inherit an old timeout. Active background work and other waiting callers remain protected.
Since version 1.5.2, Settings → Diagnostics shows request durations, error codes, request IDs and individual mail loading steps. Download log exports the entries as JSON. Up to 1000 entries per user are retained for seven days in the existing SQLite database; recording starts with this update. Passwords, tokens, message contents, subjects, search terms and folder names are excluded. No data is automatically sent to an external diagnostic service.
Unfiltered lists fetch only the requested page. Background checks use a separate connection. Disabling all-folder checks polls only INBOX; other counters update when opened. Errors remain visible with expandable details. See PERFORMANCE.md for deadlines, large attachments and troubleshooting.
🧭 Choose your installation
| Variant | Stack file | Includes |
|---|
| 📬 Webmail without ONLYOFFICE | docker-compose.yml | Mail, contacts, calendars and files; built-in image/text previews, Office file downloads |
| 📝 Webmail with ONLYOFFICE | docker-compose.onlyoffice.yml | All standard features plus document previews and editing through an additional ONLYOFFICE container |
Choose one complete stack file. The ONLYOFFICE file already includes frontend and backend; do not create a second webmail stack or combine the two files.
Choose the standard variant when available RAM is limited. ONLYOFFICE lists at least 4 GB RAM for its Docker installation; the operating system, webmail and other services need additional memory. 8 GB or more is a practical recommendation for a shared server, depending on document size and concurrent use. The standard variant needs no document server and can be extended later. ONLYOFFICE system requirements.
🚀 Installation with Docker Compose
Optional calendar connections and OAuth setup are described in CALENDAR.md. Enter Google/Microsoft client credentials directly through Calendar → Add calendar → Connect calendar. Google requires an HTTPS domain. The personal calendar works without additional configuration.
Files provides private storage on your server immediately. Optionally connect Google Drive or OneDrive through Files → Add cloud storage. Register the additional file permissions and callback URLs; calendar connections remain separate. See FILES.md for setup, limits and reverse-proxy settings. Defaults: 1 GB per file and 5 GB private storage per user. Local file contents are encrypted in the existing data volume; filenames and metadata are stored in SQLite.
Requirements:
- Docker with Docker Compose and Linux containers
- An HTTPS domain for public access, e.g. through Nginx Proxy Manager
- Only for optional mail access: IMAP and provider OAuth2 or an email/app password
Download docker-compose.yml and run this command from its directory:
docker compose up -d
Then open:
http://SERVER-IP:8886
On your own computer:
http://localhost:8886
The database and encryption key are created automatically on first startup.
🧩 Installation with Portainer
For a Docker Standalone environment:
- Open Stacks → Add stack → Web editor.
- Choose a stack name, such as
post-webmail.
- Paste the contents of docker-compose.yml.
- Add the environment variables described below if needed.
- Select Deploy the stack.
Then open the webmail at http://SERVER-IP:8886.
📝 Install with ONLYOFFICE
Use webmail images containing the ONLYOFFICE integration (v1.4.0 or later). For a new installation, use the complete docker-compose.onlyoffice.yml. Extend an existing installation in the same Compose project or existing Portainer stack, keeping its data volume.
- Generate a random key on the server with
openssl rand -hex 32.
- Create a separate Office subdomain such as
office.example.com. In Nginx Proxy Manager, forward to HTTP → Docker server IP → port 8888, enable Websockets Support, and configure a valid SSL certificate with Force SSL. If you change ONLYOFFICE_PORT, change the proxy target port too. Webmail keeps its own address and existing port.
- Set these values in
.env or the Portainer stack's Environment variables:
WEBMAIL_VERSION=2.0.0
WEBMAIL_PORT=8886
ONLYOFFICE_URL=https://office.example.com
ONLYOFFICE_JWT_SECRET=REPLACE_WITH_YOUR_GENERATED_KEY
ONLYOFFICE_PORT=8888
ONLYOFFICE_VERSION=9.4.0.1
ONLYOFFICE_MAX_FILE_MB=50
Replace the domain and key; retain your chosen ports and available webmail version. You can also use latest. The Office port must be available. Keep the key private.
Docker Compose: Run from your existing project directory:
docker compose -f docker-compose.onlyoffice.yml up -d
Portainer: In the existing stack's Editor, paste the complete docker-compose.onlyoffice.yml, retain the existing data/port/OAuth settings, and select Update the stack → Re-pull image and redeploy. For a new installation, use this file when creating the stack.
The optional stack automatically sets ONLYOFFICE_ENABLED=true, ONLYOFFICE_INTERNAL_URL=http://onlyoffice and ONLYOFFICE_CALLBACK_BASE_URL=http://backend:3000. These three values do not need .env entries for this stack. Setting only ONLYOFFICE_ENABLED=true with the normal file does not start a document server.
Allow a few minutes for initial startup, reload webmail with CTRL + F5, and open a PDF, DOCX, XLSX or PPTX under Files. Choose Edit, save a small change, close the preview and reopen the file. Changes are saved to the same file in private storage, Google Drive or OneDrive. Continue editing native Google documents at the provider; images and text keep their existing previews.
ONLYOFFICE processes decrypted documents and may retain them in its own cache volumes. Protect these volumes and backups too. See ONLYOFFICE.md for detailed setup, limits and recovery.
Return to the standard variant: Save and close active editing sessions first. Set ONLYOFFICE_ENABLED=false and replace the stack with the complete normal Compose file in the same project. In Portainer, also remove the deleted ONLYOFFICE service during the update. With Docker Compose:
docker compose -f docker-compose.onlyoffice.yml stop onlyoffice
docker compose -f docker-compose.yml up -d --remove-orphans
The additional document server no longer runs. Named data volumes are retained; --remove-orphans removes containers in the same Compose project whose services are absent from the selected file.
⚙️ Every .env variable explained
For Docker Compose, save .env.example as .env next to the chosen Compose file and adjust it. In Portainer, enter the same values in the stack's Environment variables. Not every variable needs a value; the standard variant works without OAuth or Office credentials. Do not publish .env files containing real keys or secrets.
Webmail and private file storage
| Variable | Purpose | Default |
|---|
DOCKERHUB_NAMESPACE | Namespace of the provided webmail images; normally leave unchanged | paquele |
WEBMAIL_VERSION | Image version for frontend and backend, such as 2.0.0 or latest | latest |
WEBMAIL_PORT | Available Docker host port for webmail | 8886 |
WEBMAIL_DATA_DIR | Optional host data directory instead of the named volume; holds the database, key and local files | Docker volume webmail_data |
FILES_MAX_UPLOAD_MB | Maximum size of one uploaded file in MiB; independent of the Office limit | 1024 (1 GiB) |
FILES_QUOTA_MB | Private storage quota per user in MiB; includes trash and encrypted cloud/Office working copies | 5120 (5 GiB) |
A custom host directory must be writable by the backend user with UID 1000. Keep the same data location and Compose project name when updating. Set sizes as positive integers; 1024 MiB = 1 GiB. Leave space within the quota for temporary working copies.
Calendars and cloud connections: optional server defaults
You can enter OAuth credentials directly when connecting in webmail. These server defaults may then remain blank or be omitted. Settings saved through the interface apply per user and take precedence over server defaults. A file connection without its own OAuth configuration can fall back to the same provider's calendar configuration; calendar/file permissions and authorization remain separate.
| Variable | Purpose | Default |
|---|
PUBLIC_BASE_URL | Public HTTPS webmail address, such as https://post.example.com, with no subpath; basis for OAuth callbacks when using server defaults | blank |
GOOGLE_CLIENT_ID | Optional Google OAuth client ID as a mail/calendar/Drive default | blank |
GOOGLE_CLIENT_SECRET | Matching Google client secret; not a mail/app password | blank |
MICROSOFT_CLIENT_ID | Optional Microsoft OAuth application ID as a mail/calendar/OneDrive default | blank |
MICROSOFT_CLIENT_SECRET | Matching Microsoft client secret value | blank |
MICROSOFT_TENANT_ID | Microsoft directory/tenant for the server default; a specific tenant ID can also be used | common |
ALLOW_PRIVATE_CALDAV | true additionally allows CalDAV connections to private/internal server addresses; enable only if needed | false |
When using server defaults, set PUBLIC_BASE_URL and both client credentials for the provider. When configuring through the interface, enter the webmail address and credentials there. OAuth credentials are stored encrypted in SQLite. Local calendars and private file storage need no OAuth application. Provider setup, permissions and exact callback addresses are documented in CALENDAR.md and FILES.md.
ONLYOFFICE
| Variable | Purpose | Default / behavior |
|---|
ONLYOFFICE_ENABLED | Enables Office integration in the backend; does not start a container by itself | false in the normal file; fixed true in the optional file |
ONLYOFFICE_URL | Public HTTPS document server address, such as https://office.example.com; browser-accessible, with no subpath | blank; required for ONLYOFFICE |
ONLYOFFICE_INTERNAL_URL | Address used by our backend to reach the document server internally | normal file: falls back to the Office URL; optional file: fixed http://onlyoffice |
ONLYOFFICE_CALLBACK_BASE_URL | Our webmail backend address where ONLYOFFICE fetches documents and sends save callbacks; not the Office subdomain | normal file: falls back to PUBLIC_BASE_URL; optional file: fixed http://backend:3000 |
ONLYOFFICE_JWT_SECRET | Shared random key for the webmail backend and ONLYOFFICE, at least 32 characters; generate with openssl rand -hex 32 | blank; required for ONLYOFFICE |
ONLYOFFICE_MAX_FILE_MB | Maximum document size for viewing/editing in MiB; integer from 1 to 100; ordinary uploads may be larger | 50 |
ONLYOFFICE_VERSION | Version of the separate ONLYOFFICE image, independent of WEBMAIL_VERSION; used only by the optional file | 9.4.0.1 |
ONLYOFFICE_PORT | Available document server host port; target port in Nginx Proxy Manager | 8888; used only by the optional file |
The optional file fixes ENABLED, INTERNAL_URL and CALLBACK_BASE_URL, overriding any .env entries for those three settings. An existing external document server can instead be connected through the normal file with appropriate Office variables.
🔐 Sign-in
Sign in with your own post. user account and post. password. New users can register and are approved by an administrator. First setup requires the code in the backend data volume; see MULTIUSER.md.
Then connect Google or Microsoft using OAuth2 in Settings → Account & connections. Other providers retain automatic IMAP/SMTP discovery with an email/app password. Contacts, calendars and files also work without a connected mailbox. Personal connections and data belong to their respective user.
🖥️ Your mailbox, your layout
Choose between three views:
| View | Description |
|---|
| 📋 List | Message list; messages open in the workspace |
| ⬇️ Bottom reading pane | Message list above, preview below |
| ➡️ Right reading pane | Message list on the left, preview on the right |
Additional options:
- Resize the folder sidebar
- Resize the reading pane
- Reorder columns using drag-and-drop
- Adjust column widths
- Set the number of messages per page
- Switch between light and dark mode
⌨️ Multiple selection
| Action | Result |
|---|
CTRL / CMD + click | Select or deselect individual messages |
SHIFT + click | Select a continuous range |
CTRL + SHIFT + click | Add a range to the current selection |
The selection menu provides All, None, Read and Unread for the current page.
💌 Messages
- Compose new messages
- Reply and reply to all
- Forward messages
- Compose HTML and plain-text messages
- Use recipients, Cc and Bcc
- Add attachments up to 20 MB combined
- Download received attachments
- Mark messages as read or unread
- Add stars
- Move, archive or file messages as spam
- Export messages as EML
- View message source
- Print messages
Deleting normally moves messages to Trash. Permanent deletion requires confirmation.
✍️ Composition and signatures
- Custom sender name and reply-to address
- Personal signature
- Configurable HTML font and font size
- Replies above or below the original message
- Configurable signature placement
- Forwarding as embedded text or an EML attachment
- Automatic conversion of URLs into links
- Spellchecking with browser support
- Options for read and delivery receipts
- Automatic draft saving
Draft attachments are not currently stored permanently. You may need to attach them again after reopening a draft.
🔍 Search across folders
Search covers all selectable folders, including hidden folders.
Available search fields:
- All — including message text
- Subject
- From
- To
An animated indicator shows that a search is running. Results are displayed across pages.
Search duration depends on mailbox size and mailserver performance.
📁 Folders and archive
- Expandable folder hierarchy
- Show or hide folders
- Create custom folders and subfolders
- Select a parent folder in the creation dialog
- Delete custom folders after confirmation
- Assign special folders individually
Deleting a folder also removes its messages and subfolders. System folders are protected.
Available archive structures:
- No subdivision
- By year or month
- Thunderbird-style month folders
- By sender email address
- By original folder
- Year and original folder
- Year, month and original folder
If no archive folder has been configured, a selection dialog appears on first use.
👥 Contacts and address books
The contact interface has three sections:
Address books and groups → Contact list → Contact details
- Create and delete custom address books
- Create, edit and delete contacts
- Move contacts between address books
- Organize contacts into groups
- Choose a default address book
- Search, sort and print contacts
- Export contacts as CSV or vCard
- Compose messages directly to a contact
The personal default address book is preserved. Deleting an address book removes its contacts after confirmation. Deleting a group only removes the group membership.
Contact information:
- First name, additional names and last name
- Titles and name suffixes
- Multiple email addresses
- Multiple phone numbers with types
- Multiple postal addresses
- Company, department and job title
- Birthday and other personal details
- Notes and additional fields
- Contact picture in PNG, JPEG or WebP format up to 500 KB
Contacts without email addresses are supported.
📥 CSV import from Google and Outlook
Under Contacts → Import CSV:
- Select a CSV file.
- Review the preview and detected contact count.
- Choose the destination address book.
- Select the duplicate-handling option.
- Start the import.
| Property | Support |
|---|
| Delimiters | Commas, semicolons and tabs |
| Encoding | UTF-8, UTF-16 and Windows-1252 |
| Special content | Quoted fields and multiline notes |
| Maximum file size | 10 MB |
| Maximum contact count | 10,000 per import |
Contacts without email addresses are included. People sharing an email address remain separate contacts.
“Skip identical contacts” prevents importing fully identical records again.
Unmapped details and invalid email values are retained as additional fields when the contact otherwise contains valid contact information.
⚙️ Settings
| Area | Options |
|---|
| 🖥️ User interface | Language, timezone, time/date formats and short dates |
| 🎨 Theme editor | Light/dark colors, font, font size, live preview and reset |
| 📬 Mailbox view | Layout, page size and read-marking delay |
| 🔔 Notifications | In-app notices, desktop notifications and sounds |
| 👁️ Message display | HTML/plain text, external images, emoticons and long quotations |
| ✍️ Message composition | Formatting, draft saving, reply and signature rules |
| 👥 Contacts | Default address book, display, sorting and autocomplete |
| 📁 Special folders | Drafts, Sent, Spam, Trash and Archive |
| 🗂️ Archive | Subdivision and filing structure |
| 🛠️ Server behavior | Deletion, read marking and cleanup on sign-out |
| 👤 Sender identity | Display name, reply-to address and signature |
🎨 Make the theme your own
Open Settings → Theme editor to customize the interface:
- Colors: Accent, background, surfaces and text; light and dark modes have separate colors.
- Presets: Start with Blue, Lavender, Mint or Rose.
- Font: Default/System, Arial, Verdana, Georgia or Monospace; available local fonts or suitable fallbacks are used.
- Size: A 14–20 px base size; headings, lists and labels scale proportionally.
- Preview: Changes appear immediately. Choose Save to keep them; leaving settings without saving discards the preview.
- Reset: Restore defaults resets both color modes and the font. Save to keep the restored defaults.
Themes are stored per user in SQLite and loaded when signing in on other devices. The demo stores them locally in the browser. When text contrast is low, the editor offers a suitable text color. HTML emails and ONLYOFFICE documents retain their own formatting. No additional containers, .env variables or font downloads are needed.
🖼️ External images
Three settings are available:
- Ask: Block images initially and load them when requested.
- Always: Load external images automatically.
- Never: Block external images.
Active content and external stylesheets remain blocked.
Loading external images may be visible to the sender.
🔔 Notifications
In-app notices, desktop notifications and notification sounds can be configured separately.
Desktop notifications require browser permission. The webmail must remain open; browsers may delay checks in background tabs.
🗄️ Storage and security
Emails and their folders remain on the IMAP server.
SQLite stores data including:
- Accounts and encrypted credentials
- User preferences
- Address books, contacts and groups
- Drafts and receipt records
Application data is stored persistently. Keep the database and secret.key together when creating backups.
Credentials are encrypted using AES-256-GCM. Mailserver connections use TLS. HTML messages are sanitized and displayed in isolation.
For internet access, use HTTPS through a reverse proxy. The Compose setup itself serves HTTP.
🎨 Demo
Select “View demo” on the sign-in page to explore the interface using sample data.
The demo does not connect to a mailserver or send messages.
📬 post. — a calmer inbox.
