From e8066593a7b9ca836bd0f77a62679e8b19334cb0 Mon Sep 17 00:00:00 2001
From: myOmikron <git@omikron.dev>
Date: Tue, 24 May 2022 20:36:29 +0200
Subject: [PATCH] Added section to describe setup of logrotation

---
 .../firststeps-logging.de.md                  | 25 +++++++++++++++++++
 .../firststeps-logging.en.md                  | 24 ++++++++++++++++++
 2 files changed, 49 insertions(+)

diff --git a/docs/post_installation/firststeps-logging.de.md b/docs/post_installation/firststeps-logging.de.md
index 2d930b9a5..547c10d87 100644
--- a/docs/post_installation/firststeps-logging.de.md
+++ b/docs/post_installation/firststeps-logging.de.md
@@ -119,3 +119,28 @@ Für Syslog:
 ```
 
 Starten Sie den Docker-Daemon neu und führen Sie `docker-compose down && docker-compose up -d` aus, um die Container mit dem neuen Protokollierungstreiber neu zu erstellen.
+
+### Log rotation
+
+Da diese Logs sehr groß werden können, ist es eine gute Idee logrotate zu nutzen, um Logs nach einer gewissen Zeit zu
+komprimieren und zu löschen.
+
+Erstellen Sie die Datei `/etc/logrotate.d/mailcow` mit folgendem Inhalt:
+
+```
+/var/log/mailcow.log {
+        rotate 7
+        daily
+        compress
+        delaycompress
+        missingok
+        notifempty
+        create 660 root root
+}
+```
+
+Mit dieser Konfiguration wird logrotate täglich ausgeführt und es werden maximal 7 Archive gespeichert.
+
+Um die Logdatei wöchentlich oder monatlich zu rotieren, muss `daily` durch `wekkly` oder respektive `monthly` ersetzt werden.
+
+Um mehr Archive zu speichern, muss die Nummer hinter `rotate` angepasst werden.
diff --git a/docs/post_installation/firststeps-logging.en.md b/docs/post_installation/firststeps-logging.en.md
index 249d26a1a..5bddddf19 100644
--- a/docs/post_installation/firststeps-logging.en.md
+++ b/docs/post_installation/firststeps-logging.en.md
@@ -118,3 +118,27 @@ For Syslog:
 ```
 
 Restart the Docker daemon and run `docker-compose down && docker-compose up -d` to recreate the containers with the new logging driver.
+
+### Log rotation
+
+As those logs can get quite big, it is a good idea to use logrotate to compress and delete them after a certain time period.
+
+Create `/etc/logrotate.d/mailcow` with the following content:
+
+```
+/var/log/mailcow.log {
+        rotate 7
+        daily
+        compress
+        delaycompress
+        missingok
+        notifempty
+        create 660 root root
+}
+```
+
+With this configuration, logrotate will run daily and keep a maximum of 7 archives.
+
+To rotate the logfile weekly or monthly replace `daily` with `weekly` or `monthly` respectively.
+
+To keep more archives, set the desired number of `rotate`.