diff --git a/docs/email.txt b/docs/email.txt
index fb67745f827c594b4659706ba696e8ff8e2417bf..a24376e7f089c2ce1200a34980f06a64073de6f4 100644
--- a/docs/email.txt
+++ b/docs/email.txt
@@ -1,3 +1,12 @@
+# Configuration for users
+
+SMTP/IMAP server: mail.archlinux.org
+SMTP port: 587 STARTTLS
+IMAP port: 143 (STARTTLS), 993 (TLS)
+
+username: the system account name
+password: set by each user themselves with `passwd` on orion
+
 # Adding new archlinux.org email addresses
 
 Login to orion and edit `/etc/postfix/users`, add the new email address in the