From 9d2e6709edacd33c9a49442f1b3c8b7cb5197b72 Mon Sep 17 00:00:00 2001
From: Sangelo <contact@sangelo.space>
Date: Thu, 25 Apr 2024 12:05:35 +0200
Subject: [PATCH] [a] mailcow docs

---
 content/docs/services/_index.md             |  3 ++-
 content/docs/services/authentik/_index.md   |  2 ++
 content/docs/services/mail/_index.md        |  8 ++++++
 content/docs/services/mail/configuration.md | 28 +++++++++++++++++++++
 4 files changed, 40 insertions(+), 1 deletion(-)
 create mode 100644 content/docs/services/mail/_index.md
 create mode 100644 content/docs/services/mail/configuration.md

diff --git a/content/docs/services/_index.md b/content/docs/services/_index.md
index 0ea3436..6897b4d 100644
--- a/content/docs/services/_index.md
+++ b/content/docs/services/_index.md
@@ -10,5 +10,6 @@ date = 2024-02-15
 Documentation for our deployed Services
 
 {{< cards >}}
-  {{< card link="/services/authentik" title="Authentik" subtitle="Your one stop shop all things Login!" icon="user" >}}
+  {{< card link="/docs/services/authentik" title="Authentik" subtitle="Your one stop shop all things Login!" icon="user" >}}
+  {{< card link="/docs/services/mail" title="Lunivity Mail" subtitle="All things Lunivity Mail" icon="mail" >}}
 {{< /cards >}}
diff --git a/content/docs/services/authentik/_index.md b/content/docs/services/authentik/_index.md
index 864c930..f75ea9e 100644
--- a/content/docs/services/authentik/_index.md
+++ b/content/docs/services/authentik/_index.md
@@ -2,3 +2,5 @@
 title = 'Authentik'
 date = 2024-01-09
 +++
+
+coming soon
diff --git a/content/docs/services/mail/_index.md b/content/docs/services/mail/_index.md
new file mode 100644
index 0000000..52de966
--- /dev/null
+++ b/content/docs/services/mail/_index.md
@@ -0,0 +1,8 @@
++++
+title = 'Lunivity Mail'
+date = 2024-04-25
++++
+
+{{< cards >}}
+  {{< card link="/docs/services/mail/configuration" title="Configuration" subtitle="How to configure your Mail client" icon="cog" >}}
+{{< /cards >}}
diff --git a/content/docs/services/mail/configuration.md b/content/docs/services/mail/configuration.md
new file mode 100644
index 0000000..2925d94
--- /dev/null
+++ b/content/docs/services/mail/configuration.md
@@ -0,0 +1,28 @@
++++
+linkTitle = 'Configuration'
+title = 'Configuring your Mail Client'
+date = 2024-04-25
++++
+
+This article is an adapted version of [this](https://docs.mailcow.email/client/client-manual/) official Mailcow documentation.
+
+## Mailbox
+
+If you are the proud owner of an @stardust.foo E-Mail address, here's how you can configure it.
+
+| Service | Encryption | Host               | Port | Username                  |
+|:-------:|:----------:|:------------------:|:----:|:-------------------------:|
+|  IMAP   |  STARTTLS  | mail.lunivity.com  | 143  | `username@stardust.foo` |
+|  SMTP   |  STARTTLS  | mail.lunivity.com  | 587  | `username@stardust.foo` |
+
+Please choose the "plain" password option (or "Normal Password" in Thunderbird) for authentication.
+Despite the name, your password won't be sent as plain text to the server, as authentication requires TLS encryption.
+
+## Contacts and calendars
+
+Here are SOGo's default CalDAV and CardDAV URLs:
+
+- **CalDAV**: `https://mail.lunivity.com/SOGo/dav/username@stardust.foo/Calendar/personal/`
+- **CardDAV**: `https://mail.lunivity.com/SOGo/dav/username@stardust.foo/Contacts/personal/`
+
+Some apps might need this URL: `https://mail.lunivity.com/SOGo/dav/`, or the full calendar path, which you can find and copy from within SOGo.