prune mail for a specific user

scripts/mail_prune_user.sh

@@ -0,0 +1,126 @@
+#!/bin/sh
+
+#######
+### cleanup a certain user's messages in ALL mail folders older than x days 
+### that are SEEN and UNflagged
+###
+### This script is meant to be executed as a CRON job so there is no friendly
+### user output or error trapping. Check logs for errors.
+#######
+
+
+### functions
+
+# bad parameters
+badParam () {
+    if [ "$1" = "empty" ]; then
+        printf "\n'%s' cannot have a NULL (empty) value.\n" "$2"
+        printf "Please use '--help' for assistance.\n\n"
+    elif [ "$1" = "nospecify" ]; then
+        printf "\n'%s' was not specified.\n" "$2"
+        printf "Please use '--help' for assistance.\n\n"
+    fi
+    exit 1
+}
+
+# script help
+scriptHelp () {
+    printf "\n*** Delete ALL messages older than x days for a certain user ***\n"
+    printf "*** only READ and UNFLAGGED messages will be removed ***\n\n"
+    printf "Usage: ./mail_prune_user.sh -d|--days x -u|--user y [-p|--path|--mailcow-path path]\n"
+    printf "\n\tWhere:\n"
+    printf "\t\tx: delete messages (ALL folders) older than this many days\n"
+    printf "\t\ty: target USER y\n"
+    printf "\t\tpath: path to your mailcow-dockerized installation\n"
+    printf "\t\t(default: /opt/mailcow-dockerized)\n\n"
+    exit 0
+}
+
+
+### startup parameters
+
+# set defaults
+mailcowPath="/opt/mailcow-dockerized"
+
+# no parameters given, show help
+if [ $# -le 0 ]; then
+    scriptHelp
+fi
+
+# process startup parameters
+while [ $# -gt 0 ]; do
+    case "$1" in
+        -h|-\?|--help)
+            # display help
+            scriptHelp
+            exit 0
+            ;;
+        -d|--days)
+            # delete messages older than this many days
+            if [ -n "$2" ]; then
+                deleteOlder="$2"
+                shift
+            else
+                badParam empty "$@"
+            fi
+            ;;
+        -u|--user)
+            # target this specific user
+            if [ -n "$2" ]; then
+                user="$2"
+                shift
+            else
+                badParam empty "$@"
+            fi
+            ;;
+        -p|--path|--mailcow-path)
+            # path to mailcow directory
+            if [ -n "$2" ]; then
+                mailcowPath="$2"
+                shift
+            else
+                badParam empty "$@"
+            fi
+            ;;
+        *)
+            printf "Unknown option: %s\n" "$1"
+            printf "Use '--help' for valid options\n\n"
+            exit 1
+            ;;
+    esac
+    shift
+done
+
+
+### check for missing parameters
+if [ -z "$deleteOlder" ]; then
+    badParam nospecify '--days'
+elif [ -z "$user" ]; then
+    badParam nospecify '--user'
+fi
+
+
+### display parameters being used
+printf "\nUsing parameters:\n"
+printf "targetting %s\n" "$user"
+printf "delete ALL messages older than %s days\n" "$deleteOlder"
+printf "mailcow path: %s\n\n" "$mailcowPath"
+
+
+### execute doveadm using parameters provided
+if ! cd "$mailcowPath" > /dev/null 2>&1; then
+    printf "Can't change to specified mailcow-dockerized directory!\n"
+    printf "\t(%s)\n\n" "$mailcowPath"
+    printf "Exiting. No actions performed.\n\n"
+    exit 2
+fi
+
+# delete messages for user
+printf "Deleting OLD messages for %s...\n" "$user"
+/usr/local/bin/docker-compose exec -T dovecot-mailcow doveadm expunge -u "$user" mailbox '*' SEEN UNFLAGGED BEFORE "${deleteOlder}d"
+
+
+### exit gracefully
+printf "...done\n\n"
+
+exit 0