diff --git a/docs/assets/js/client.js b/docs/assets/javascript/client.js
similarity index 100%
rename from docs/assets/js/client.js
rename to docs/assets/javascript/client.js
diff --git a/docs/client/client-android.de.md b/docs/client/client-android.de.md
new file mode 100644
index 000000000..da646d150
--- /dev/null
+++ b/docs/client/client-android.de.md
@@ -0,0 +1,5 @@
+1. Öffnen Sie die App *Email*.
+2. Wenn dies Ihr erstes E-Mail-Konto ist, tippen Sie auf *Konto hinzufügen*; wenn nicht, tippen Sie auf *Mehr* und *Einstellungen* und dann *Konto hinzufügen*.
+3. Wählen Sie *Microsoft Exchange ActiveSync*.
+4. Geben Sie Ihre E-Mail Adresse () und Ihr Passwort ein.
+5. Tippen Sie auf *Anmelden*.
\ No newline at end of file
diff --git a/docs/client/client-android.en.md b/docs/client/client-android.en.md
new file mode 100644
index 000000000..3b5df836f
--- /dev/null
+++ b/docs/client/client-android.en.md
@@ -0,0 +1,5 @@
+1. Open the *Email* app.
+2. If this is your first email account, tap *Add Account*; if not, tap *More* and *Settings* and then *Add account*.
+3. Select *Microsoft Exchange ActiveSync*.
+4. Enter your email address (
) and password.
+5. Tap *Sign in*.
\ No newline at end of file
diff --git a/docs/client/client-apple.de.md b/docs/client/client-apple.de.md
new file mode 100644
index 000000000..b1ff53a6d
--- /dev/null
+++ b/docs/client/client-apple.de.md
@@ -0,0 +1,26 @@
+## Methode 1 über Mobileconfig
+
+E-Mail, Kontakte und Kalender können auf Apple-Geräten automatisch konfiguriert werden, indem ein Profil installiert wird. Um ein Profil herunterzuladen, müssen Sie sich zuerst in der mailcow UI anmelden.
+
+## Methode 1.1: IMAP, SMTP und Cal/CardDAV
+
+Diese Methode konfiguriert IMAP, CardDAV und CalDAV.
+1. Downloaden und öffnen die Datei von https://${MAILCOW_HOSTNAME}/mobileconfig.phpmailcow.mobileconfig.
+2. Geben Sie den Entsperrungscode (iPhone) oder das Computerpasswort (Mac) ein.
+3. Geben Sie Ihr E-Mail-Passwort dreimal ein, wenn Sie dazu aufgefordert werden.
+
+## Methode 1.2: IMAP, SMTP (kein DAV)
+
+Diese Methode konfiguriert nur IMAP und SMTP.
+1. Downloaden und öffnen Sie die Datei von https://${MAILCOW_HOSTNAME}/mobileconfig.php?only_emailmailcow.mobileconfig.
+2. Geben Sie den Entsperrungscode (iPhone) oder das Computerpasswort (Mac) ein.
+3. Geben Sie Ihr E-Mail-Passwort dreimal ein, wenn Sie dazu aufgefordert werden.
+
+## Methode 2 (Exchange ActiveSync-Emulation)
+
+Unter iOS wird auch Exchange ActiveSync als Alternative zum obigen Verfahren unterstützt. Es hat den Vorteil, dass es Push-E-Mail unterstützt (d. h. Sie werden sofort über eingehende Nachrichten benachrichtigt), hat aber einige Einschränkungen, z. B. unterstützt es nicht mehr als drei E-Mail-Adressen pro Kontakt in Ihrem Adressbuch. Befolgen Sie die folgenden Schritte, wenn Sie stattdessen Exchange verwenden möchten.
+
+1. Öffnen Sie die App *Einstellungen*, tippen Sie auf *Mail*, tippen Sie auf *Konten*, tippen Sie auf *Konto hinzufügen*, wählen Sie *Exchange*.
+2. Geben Sie Ihre E-Mail Adresse (
) ein und tippen Sie auf *Weiter*.
+3. Geben Sie Ihr Passwort ein und tippen Sie erneut auf *Weiter*.
+4. Tippen Sie abschließend auf *Speichern*.
\ No newline at end of file
diff --git a/docs/client/client-apple.en.md b/docs/client/client-apple.en.md
new file mode 100644
index 000000000..f115c3c4e
--- /dev/null
+++ b/docs/client/client-apple.en.md
@@ -0,0 +1,28 @@
+## Method 1 via Mobileconfig
+
+Email, contacts and calendars can be configured automatically on Apple devices by installing a profile. To download a profile you must login to the mailcow UI first.
+
+## Method 1.1: IMAP, SMTP and Cal/CardDAV
+
+This method configures IMAP, CardDAV and CalDAV.
+
+1. Download and open the file from https://${MAILCOW_HOSTNAME}/mobileconfig.phpmailcow.mobileconfig.
+2. Enter the unlock code (iPhone) or computer password (Mac).
+3. Enter your email password three times when prompted.
+
+## Method 1.2: IMAP, SMTP (no DAV)
+
+This method configures IMAP and SMTP only.
+
+1. Download and open the file from https://${MAILCOW_HOSTNAME}/mobileconfig.php?only_emailmailcow.mobileconfig.
+2. Enter the unlock code (iPhone) or computer password (Mac).
+3. Enter your email password when prompted.
+
+## Method 2 (Exchange ActiveSync emulation)
+
+On iOS, Exchange ActiveSync is also supported as an alternative to the procedure above. It has the advantage of supporting push email (i.e. you are immediately notified of incoming messages), but has some limitations, e.g. it does not support more than three email addresses per contact in your address book. Follow the steps below if you decide to use Exchange instead.
+
+1. Open the *Settings* app, tap *Mail*, tap *Accounts*, tap *Add Acccount*, select *Exchange*.
+2. Enter your email address (
) and tap *Next*.
+3. Enter your password, tap *Next* again.
+4. Finally, tap *Save*.
\ No newline at end of file
diff --git a/docs/client/client-emclient.de.md b/docs/client/client-emclient.de.md
new file mode 100644
index 000000000..a6db771a4
--- /dev/null
+++ b/docs/client/client-emclient.de.md
@@ -0,0 +1,7 @@
+1. Starten Sie eM Client.
+2. Wenn Sie eM Client zum ersten Mal starten, werden Sie aufgefordert, Ihr Konto einzurichten. Fahren Sie mit Schritt 4 fort.
+3. Gehen Sie oben auf *Menü*, wählen Sie *Tools* und *Konten*.
+4. Geben Sie Ihre E-Mail Adresse ein (
) und klicken Sie auf *Jetzt starten*.
+5. Geben Sie Ihr Passwort ein und klicken Sie auf *Weiter*.
+6. Geben Sie Ihren Namen ein (
) und klicken Sie auf *Weiter*.
+7. Klicken Sie auf *Fertigstellen*.
diff --git a/docs/client/client-emclient.en.md b/docs/client/client-emclient.en.md
new file mode 100644
index 000000000..7ab93d60e
--- /dev/null
+++ b/docs/client/client-emclient.en.md
@@ -0,0 +1,7 @@
+1. Launch eM Client.
+2. If this is the first time you launched eM Client, it asks you to set up your account. Proceed to step 4.
+3. Go to *Menu* at the top, select *Tools* and *Accounts*.
+4. Enter your email address (
) and click *Start Now*.
+5. Enter your password and click *Continue*.
+6. Enter your name (
) and click *Next*.
+7. Click *Finish*.
\ No newline at end of file
diff --git a/docs/client/client-kontact.de.md b/docs/client/client-kontact.de.md
new file mode 100644
index 000000000..bcb449531
--- /dev/null
+++ b/docs/client/client-kontact.de.md
@@ -0,0 +1,16 @@
+1. Starten Sie Kontact.
+2. Wenn Sie Kontact oder KMail zum ersten Mal gestartet haben, werden Sie aufgefordert, Ihr Konto einzurichten. Fahren Sie mit Schritt 4 fort.
+3. Gehen Sie zu *Mail* in der Seitenleiste. Gehen Sie zum Menü *Tools* und wählen Sie *Account Wizard*.
+4. Geben Sie Ihren Namen (
), E-Mail Adresse (
) und Ihr Passwort ein. Klicken Sie auf *Weiter*.
+5. Klicken Sie auf *Konto erstellen*. Wenn Sie dazu aufgefordert werden, geben Sie Ihr Passwort erneut ein und klicken Sie auf *OK*.
+6. Schließen Sie das Fenster, indem Sie auf *Beenden* klicken.
+7. Gehen Sie zu *Kalender* in der Seitenleiste.
+8. Gehen Sie zum Menü *Einstellungen* und wählen Sie *Konfigurieren Sie KOrganizer*.
+9. Gehen Sie zur Registerkarte *Kalender* und klicken Sie auf die Schaltfläche *Hinzufügen*.
+10. Wählen Sie *DAV-Groupware-Ressource* und klicken Sie auf *OK*.
+11. Geben Sie Ihre E-Mail Adresse (
) und Ihr Passwort ein. Klicken Sie auf *Weiter*.
+12. Wählen Sie *ScalableOGo* aus dem Dropdown-Menü und klicken Sie auf *Weiter*.
+13. Geben Sie den
mailcow Hostname in das Feld *Host* ein und klicken Sie auf *Weiter*.
+14. Klicken Sie auf *Verbindung testen* und dann auf *Fertigstellen*. Klicken Sie abschließend zweimal auf *OK*.
+
+Sobald Sie Kontact eingerichtet haben, können Sie KMail, KOrganizer und KAddressBook auch einzeln verwenden.
\ No newline at end of file
diff --git a/docs/client/client-kontact.en.md b/docs/client/client-kontact.en.md
new file mode 100644
index 000000000..634ee6bec
--- /dev/null
+++ b/docs/client/client-kontact.en.md
@@ -0,0 +1,16 @@
+1. Launch Kontact.
+2. If this is the first time you launched Kontact or KMail, it asks you to set up your account. Proceed to step 4.
+3. Go to *Mail* in the sidebar. Go to the *Tools* menu and select *Account Wizard*.
+4. Enter your name (
), email address (
) and your password. Click *Next*.
+5. Click *Create Account*. If prompted, re-enter your password and click *OK*.
+6. Close the window by clicking *Finish*.
+7. Go to *Calendar* in the sidebar.
+8. Go to the *Settings* menu and select *Configure KOrganizer*.
+9. Go to the *Calendars* tab and click the *Add* button.
+10. Choose *DAV groupware resource* and click *OK*.
+11. Enter your email address (
) and your password. Click *Next*.
+12. Select *ScalableOGo* from the dropdown menu and click *Next*.
+13. Enter
your mailcow hostname into the *Host* field and click *Next*.
+14. Click *Test Connection* and then *Finish*. Finally, click *OK* twice.
+
+Once you have set up Kontact, you can also use KMail, KOrganizer and KAddressBook individually.
\ No newline at end of file
diff --git a/docs/client/client-manual.de.md b/docs/client/client-manual.de.md
new file mode 100644
index 000000000..58a11b482
--- /dev/null
+++ b/docs/client/client-manual.de.md
@@ -0,0 +1,22 @@
+Diese Anweisungen gelten nur für unveränderte Portbindungen!
+
+## E-Mail
+|Dienst|Verschlüsselung|Host|Port|
+|--- |--- |--- |--- |
+|IMAP|STARTTLS|
mailcow hostname|143|
+|IMAPS|SSL|
mailcow hostname|993|
+|POP3|STARTTLS|
mailcow hostname|110|
+|POP3S|SSL|
mailcow hostname|995|
+|SMTP|STARTTLS|
mailcow hostname|587|
+|SMTPS|SSL|
mailcow hostname|465|
+
+Bitte verwenden Sie "plain" als Authentifizierungsmechanismus. Entgegen der Annahme werden keine Passwörter im Klartext übertragen, da ohne TLS keine Authentifizierung stattfinden darf.
+
+## Kontakte und Kalender
+
+SOGos Standard-URLs für Kalender (CalDAV) und Kontakte (CardDAV):
+
+1. **CalDAV** - https://mail.example.com/SOGo/dav/user@example.com/Calendar/personal/
+2. **CardDAV** - https://mail.example.com/SOGo/dav/user@example.com/Contacts/personal/
+
+Einige Anwendungen verlangen möglicherweise die Verwendung von https://mail.example.com/SOGo/dav/ _oder_ den vollständigen Pfad zu Ihrem Kalender, der in SOGo gefunden und kopiert werden kann.
\ No newline at end of file
diff --git a/docs/client/client-manual.en.md b/docs/client/client-manual.en.md
new file mode 100644
index 000000000..d06c8df8c
--- /dev/null
+++ b/docs/client/client-manual.en.md
@@ -0,0 +1,23 @@
+These instructions are valid for unchanged port bindings only!
+
+## Email
+
+|Service|Encryption|Host|Port|
+|--- |--- |--- |--- |
+|IMAP|STARTTLS|
mailcow hostname|143|
+|IMAPS|SSL|
mailcow hostname|993|
+|POP3|STARTTLS|
mailcow hostname|110|
+|POP3S|SSL|
mailcow hostname|995|
+|SMTP|STARTTLS|
mailcow hostname|587|
+|SMTPS|SSL|
mailcow hostname|465|
+
+Please use "plain" as authentication mechanisms. Contrary to the assumption no passwords will be transferred plain text, as no authentication is allowed to take place without TLS.
+
+## Contacts and calendars
+
+SOGos default calendar (CalDAV) and contacts (CardDAV) URLs:
+
+1. **CalDAV** - https://mail.example.com/SOGo/dav/user@example.com/Calendar/personal/
+2. **CardDAV** - https://mail.example.com/SOGo/dav/user@example.com/Contacts/personal/
+
+Some applications may require you to use https://mail.example.com/SOGo/dav/ _or_ the full path to your calendar, which can be found and copied from within SOGo.
\ No newline at end of file
diff --git a/docs/client/client-outlook.de.md b/docs/client/client-outlook.de.md
new file mode 100644
index 000000000..d345d5ccb
--- /dev/null
+++ b/docs/client/client-outlook.de.md
@@ -0,0 +1,47 @@
+
), Ihre E-Mail Adresse (
) und Ihr Passwort ein. Klicken Sie auf *Weiter*.
+5. Wenn Sie dazu aufgefordert werden, geben Sie Ihr Passwort erneut ein, markieren Sie *Meine Anmeldedaten speichern* und klicken Sie auf *OK*.
+6. Klicken Sie auf die Schaltfläche *Zulassen*.
+7. Klicken Sie auf *Fertigstellen*.
+
+## Outlook 2007 or higher on Windows
+
+
), Ihre E-Mail Adresse (
) und Ihr Passwort ein. Klicken Sie auf *Weiter*.
+6. Klicken Sie auf *Finish*.
+7. Gehen Sie zur Multifunktionsleiste *CalDav Synchronizer* und klicken Sie auf *Synchronisationsprofile*.
+8. Klicken Sie auf die zweite Schaltfläche oben (*Mehrere Profile hinzufügen*), wählen Sie *Sogo* und klicken Sie auf *Ok*.
+9. Klicken Sie auf die Schaltfläche *IMAP/POP3-Kontoeinstellungen abrufen*.
+10. Klicken Sie auf *Ressourcen erkennen und Outlook-Ordnern zuweisen*.
+11. Wählen Sie im Fenster *Ressource auswählen* Ihren Hauptkalender (in der Regel *Persönlicher Kalender*), klicken Sie auf die Schaltfläche *...*, weisen Sie ihn dem Ordner *Kalender* zu, und klicken Sie auf *OK*. Gehen Sie zu den Registerkarten *Adressbücher* und *Aufgaben* und wiederholen Sie den Vorgang entsprechend. Weisen Sie nicht mehreren Kalendern, Adressbüchern oder Aufgabenlisten zu!
+12. Schließen Sie alle Fenster mit den Tasten *OK*.
+
+## Outlook 2011 oder höher unter macOS
+
+Die Mac-Version von Outlook synchronisiert keine Kalender und Kontakte und wird daher nicht unterstützt.
\ No newline at end of file
diff --git a/docs/client/client-outlook.en.md b/docs/client/client-outlook.en.md
new file mode 100644
index 000000000..0b45a4fa5
--- /dev/null
+++ b/docs/client/client-outlook.en.md
@@ -0,0 +1,54 @@
+
), email address (
) and your password. Click *Next*.
+5. When prompted, enter your password again, check *Remember my credentials* and click *OK*.
+6. Click the *Allow* button.
+7. Click *Finish*.
+
+## Outlook 2007 or 2010 on Windows
+
+
), email address (
) and your password. Click *Next*.
+6. Click *Finish*.
+7. Go to the *CalDav Synchronizer* ribbon and click *Synchronization Profiles*.
+8. Click the second button at top (*Add multiple profiles*), select *Sogo*, click *Ok*.
+9. Click the *Get IMAP/POP3 account settings* button.
+10. Click *Discover resources and assign to Outlook folders*.
+11. In the *Select Resource* window that pops up, select your main calendar (usually *Personal Calendar*), click the *...* button, assign it to *Calendar*, and click *OK*. Go to the *Address Books* and *Tasks* tabs and repeat repeat the process accordingly. Do not assign multiple calendars, address books or task lists!
+12. Close all windows with the *OK* buttons.
+
+## Outlook 2011 or higher on macOS
+
+The Mac version of Outlook does not synchronize calendars and contacts and therefore is not supported.
\ No newline at end of file
diff --git a/docs/client/client-thunderbird.de.md b/docs/client/client-thunderbird.de.md
new file mode 100644
index 000000000..8d57b0d7e
--- /dev/null
+++ b/docs/client/client-thunderbird.de.md
@@ -0,0 +1,26 @@
+
), Ihre E-Mail-Adresse (
) und Ihr Passwort ein. Stellen Sie sicher, dass Passwort merken aktiviert ist und klicken Sie auf Weiter.
+
), email address (
) and your password. Make sure the Remember password checkbox is selected and click Continue.
+
) ein und klicken Sie auf *Weiter*..
+6. Geben Sie Ihr Passwort ein und klicken Sie auf *Anmelden*.
+
+Sobald Sie die Mail-App eingerichtet haben, können Sie auch die Apps "Kontakte" und "Kalender" verwenden.
\ No newline at end of file
diff --git a/docs/client/client-windows.en.md b/docs/client/client-windows.en.md
new file mode 100644
index 000000000..d8e89a7fb
--- /dev/null
+++ b/docs/client/client-windows.en.md
@@ -0,0 +1,10 @@
+Windows 8 and higher support email, contacts and calendar via Exchange ActiveSync.
+
+1. Open the *Mail* app.
+2. If you have not previously used Mail, you can click *Add Account* in the main window. Proceed to step 4.
+3. Click *Accounts* in the sidebar on the left, then click *Add Account* on the far right.
+4. Select *Exchange*.
+5. Enter your email address (
) and click *Next*.
+6. Enter your password and click *Log in*.
+
+Once you have set up the Mail app, you can also use the People and Calendar apps.
\ No newline at end of file
diff --git a/docs/client/client.de.md b/docs/client/client.de.md
new file mode 100644
index 000000000..6d26b61ad
--- /dev/null
+++ b/docs/client/client.de.md
@@ -0,0 +1,25 @@
+mailcow unterstützt eine Vielzahl von E-Mail-Clients, sowohl auf Desktop-Computern als auch auf Smartphones.
+Im Folgenden finden Sie eine Reihe von Konfigurationsanleitungen, die erklären, wie Sie Ihr mailcow-Konto konfigurieren können.
+
+Tipp
+Wenn Sie auf diese Seite zugreifen, indem Sie sich bei Ihrem mailcow-Server anmelden und auf den Link "Konfigurationsanleitungen für E-Mail-Clients und Smartphones anzeigen" klicken, werden alle Anleitungen mit Ihrer E-Mail-Adresse und Ihrem Servernamen personalisiert. +Erfolgreich
+Da Sie diese Seite aufgerufen haben, nachdem Sie sich in Ihren Mailcow-Server eingeloggt haben, wurden alle Anleitungen mit Ihrer E-Mail-Adresse und Ihrem Servernamen personalisiert. +Tip
+If you access this page by logging into your mailcow server and clicking the "Show configuration guides for email clients and smartphones" link, all of the guides will be personalized with your email address and server name. +Success
+Since you accessed this page after logging into your mailcow server, all of the guides have been personalized with your email address and server name. +