paquele/post-webmail-frontend repository overview

⁠📬 post. — a calmer inbox

🐳 Docker · 🗄️ SQLite · 🌗 Light & Dark Mode · 🇩🇪 Deutsch · 🇬🇧 English

🇩🇪 Deutsche Anleitung⁠ · 🇬🇧 English documentation⁠

⁠Deutsch

⁠✨ Funktionen

⁠🚀 Installation mit Docker Compose

Voraussetzungen:

• Docker mit Docker Compose und Linux-Containern
• Ein E-Mail-Konto mit aktiviertem IMAP
• Passwort oder App-Passwort des E-Mail-Kontos

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:

1. Stacks → Add stack → Web editor öffnen.
2. Einen Stack-Namen vergeben, beispielsweise post-webmail.
3. Den Inhalt der docker-compose.yml⁠ einfügen.
4. Bei Bedarf die unten beschriebenen Umgebungsvariablen ergänzen.
5. Deploy the stack auswählen.

Danach die Webmail unter http://SERVER-IP:8886 öffnen.

⁠⚙️ Optionale Konfiguration

Für Docker Compose eine .env neben der Compose-Datei erstellen:

WEBMAIL_PORT=8886

# Optional: eigener Datenordner auf dem Docker-Host
# WEBMAIL_DATA_DIR=/pfad/zu/webmail/data

In Portainer diese Werte unter den Umgebungsvariablen des Stacks eintragen.

Ein eigener Datenordner muss für den Backend-Benutzer mit UID 1000 schreibbar sein.

⁠🔐 Anmeldung

Melde dich mit deiner E-Mail-Adresse und deinem Passwort oder App-Passwort an.

Die Anwendung ermittelt die IMAP- und SMTP-Einstellungen automatisch und prüft die Verbindung.

Bei Zwei-Faktor-Anmeldung wird häufig ein App-Passwort benötigt. IMAP muss beim Mailanbieter aktiviert sein.

⁠🖥️ Dein Postfach, deine Ansicht

Wähle zwischen drei Ansichten:

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

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

⁠🔍 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:

1. CSV-Datei auswählen.
2. Vorschau und erkannte Kontaktanzahl prüfen.
3. Zieladressbuch auswählen.
4. Duplikatbehandlung festlegen.
5. Import starten.

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

⁠🖼️ 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.

⁠🔔 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

⁠✨ Features

⁠🚀 Installation with Docker Compose

Requirements:

• Docker with Docker Compose and Linux containers
• An email account with IMAP enabled
• Your account password or 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:

1. Open Stacks → Add stack → Web editor.
2. Choose a stack name, such as post-webmail.
3. Paste the contents of docker-compose.yml⁠.
4. Add the environment variables described below if needed.
5. Select Deploy the stack.

Then open the webmail at http://SERVER-IP:8886.

⁠⚙️ Optional configuration

For Docker Compose, create a .env file next to the Compose file:

WEBMAIL_PORT=8886

# Optional: custom data directory on the Docker host
# WEBMAIL_DATA_DIR=/path/to/webmail/data

In Portainer, enter these values in the stack’s environment variables.

A custom data directory must be writable by the backend user with UID 1000.

⁠🔐 Sign-in

Sign in with your email address and password or app password.

The application automatically discovers the IMAP and SMTP settings and checks the connection.

Accounts with two-factor authentication often require an app password. IMAP must be enabled by your email provider.

⁠🖥️ Your mailbox, your layout

Choose between three views:

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

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

⁠🔍 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:

1. Select a CSV file.
2. Review the preview and detected contact count.
3. Choose the destination address book.
4. Select the duplicate-handling option.
5. Start the 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

⁠🖼️ 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.

⁠🔔 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.