Info:: apsi.net: GUIDE AJOUT COMPTE
KEYWORDS: MAIL, SERVER, APSI.NET, OVH1, MAIL.APSI.NET, OVH2, BACKUP.APSI.NET
Le 04/01/2026:
Guide d’Ajout d’un Compte Email à un Domaine Existant
Ajout rapide d’une adresse email sur un domaine déjà configuré
Date de création: 02 Janvier 2026 Serveur: ovh1 (mail.apsi.net) Domaines gérés: apsi.net, voilou.nl
Vue d’ensemble
Ce guide explique comment ajouter rapidement un nouveau compte email (nouvelle adresse) à un domaine déjà configuré sur le serveur mail.
Prérequis
- Le domaine doit déjà être configuré sur le serveur (voir GUIDE_AJOUT_DOMAINE.md sinon)
- Accès root au serveur ovh1
Temps estimé
5-10 minutes
Méthode Rapide (4 étapes)
Exemple
Nous allons ajouter support@apsi.net qui sera géré par un nouvel utilisateur Unix support.
ÉTAPE 1: Créer l’Utilisateur Unix (sur ovh1 = mail.apsi.net)
# Créer l'utilisateur avec son répertoire home
useradd -m -s /bin/bash support
# Définir le mot de passe (pour IMAP/SMTP)
echo "support:MotDePasseSecurise123!" | chpasswd
# Ou de manière interactive:
passwd support
Convention de nommage:
| Utilisateur Unix | Justification | |
|---|---|---|
support@apsi.net
|
support
|
Même domaine qu’autres comptes existants |
support@voilou.nl
|
support-voilou
|
Différencier du domaine apsi.net |
admin@apsi.net
|
admin
|
Nouveau compte sur domaine existant |
ventes@voilou.nl
|
ventes-voilou
|
Différencier du domaine apsi.net |
Règle générale: - Si c’est le premier compte avec ce nom sur ce domaine: nom simple (ex: support) - Si un compte avec ce nom existe déjà sur un autre domaine: ajouter suffixe -domaine (ex: support-voilou)
ÉTAPE 2: Créer le Maildir
# Se connecter en tant qu'utilisateur et créer le Maildir
su - support
maildirmake ~/Maildir
exit
# Vérifier que le Maildir est créé
ls -ld /home/support/Maildir/
Note: Le Maildir sera créé automatiquement à la réception du premier email si vous sautez cette étape, mais il est préférable de le créer maintenant.
ÉTAPE 3: Ajouter l’Alias Virtuel
3.1 Éditer le fichier virtual
nano /etc/postfix/virtual
3.2 Ajouter la ligne
Ajouter dans la section du domaine approprié:
# Domaine apsi.net pchevalier@apsi.net pchevalier contact@apsi.net contact support@apsi.net support # <-- NOUVELLE LIGNE
Ou directement en ligne de commande:
echo "support@apsi.net support" >> /etc/postfix/virtual
3.3 Compiler et recharger
# Compiler la table virtuelle
postmap /etc/postfix/virtual
# Vérifier la syntaxe Postfix
postfix check
# Recharger Postfix (sans interruption)
systemctl reload postfix
ÉTAPE 4: Tester
4.1 Vérifier le mapping
# Tester que l'alias fonctionne
postmap -q "support@apsi.net" hash:/etc/postfix/virtual
# Doit retourner: support
4.2 Envoyer un email de test
# Envoyer un email de test local
echo "Test email pour support" | sendmail support@apsi.net
# Vérifier la réception dans le Maildir
ls -lth /home/support/Maildir/new/
# Lire le dernier email reçu
cat $(ls -t /home/support/Maildir/new/ | head -1 | xargs -I {} echo /home/support/Maildir/new/{})
4.3 Vérifier les logs
# Voir les logs en temps réel
tail -f /var/log/mail.log
# Ou rechercher les emails pour support@apsi.net
grep "to=<support@apsi.net>" /var/log/mail.log | tail -10
Résultat attendu dans les logs:
postfix/local[12345]: ... to=<support@apsi.net>, relay=local, delay=0.01, ... status=sent (delivered to maildir)
Configuration Client (Thunderbird)
Paramètres de connexion
Serveur IMAP: - Nom d’utilisateur: support (le nom Unix, PAS l’email!) - Serveur: mail.apsi.net - Port: 143 - Sécurité: STARTTLS - Authentification: Mot de passe normal
Serveur SMTP: - Nom d’utilisateur: support - Serveur: mail.apsi.net - Port: 587 - Sécurité: STARTTLS - Authentification: Mot de passe normal
Identité: - Nom: Support APSI - Adresse email: support@apsi.net
Configuration Roundcube
URL: https://apsi.net/roundcube/
Connexion: - Utilisateur: support (le nom Unix, pas l’email!) - Mot de passe: MotDePasseSecurise123!
Aucune configuration serveur nécessaire - Roundcube utilise automatiquement le bon serveur IMAP/SMTP.
Exemples Pratiques
Exemple 1: Ajouter admin@apsi.net
# 1. Créer l'utilisateur
useradd -m -s /bin/bash admin
echo "admin:AdminPass456!" | chpasswd
# 2. Créer le Maildir
su - admin -c "maildirmake ~/Maildir"
# 3. Ajouter l'alias
echo "admin@apsi.net admin" >> /etc/postfix/virtual
postmap /etc/postfix/virtual
systemctl reload postfix
# 4. Tester
postmap -q "admin@apsi.net" hash:/etc/postfix/virtual
echo "Test" | sendmail admin@apsi.net
ls /home/admin/Maildir/new/
Exemple 2: Ajouter ventes@voilou.nl
# 1. Créer l'utilisateur (avec suffixe -voilou)
useradd -m -s /bin/bash ventes-voilou
echo "ventes-voilou:VentesPass789!" | chpasswd
# 2. Créer le Maildir
su - ventes-voilou -c "maildirmake ~/Maildir"
# 3. Ajouter l'alias
echo "ventes@voilou.nl ventes-voilou" >> /etc/postfix/virtual
postmap /etc/postfix/virtual
systemctl reload postfix
# 4. Tester
postmap -q "ventes@voilou.nl" hash:/etc/postfix/virtual
echo "Test ventes" | sendmail ventes@voilou.nl
ls /home/ventes-voilou/Maildir/new/
Exemple 3: Ajouter plusieurs alias pour un même compte
Cas d’usage: Diriger info@apsi.net, contact@apsi.net et support@apsi.net vers la même boîte mail.
# info@ et support@ vers le compte contact existant
echo "info@apsi.net contact" >> /etc/postfix/virtual
echo "support@apsi.net contact" >> /etc/postfix/virtual
postmap /etc/postfix/virtual
systemctl reload postfix
# Tester
postmap -q "info@apsi.net" hash:/etc/postfix/virtual
postmap -q "support@apsi.net" hash:/etc/postfix/virtual
# Les deux doivent retourner: contact
Exemple 4: Rediriger vers plusieurs destinataires
Cas d’usage: Les emails envoyés à equipe@apsi.net doivent être reçus par pchevalier ET contact.
# Méthode 1: Alias multiple (dans /etc/postfix/virtual)
echo "equipe@apsi.net pchevalier,contact" >> /etc/postfix/virtual
postmap /etc/postfix/virtual
systemctl reload postfix
# Méthode 2: Créer une liste de diffusion avec /etc/aliases
echo "equipe: pchevalier, contact" >> /etc/aliases
newaliases
Gestion des Alias
Voir tous les alias d’un domaine
# Voir les alias pour apsi.net
grep "@apsi.net" /etc/postfix/virtual
# Voir les alias pour voilou.nl
grep "@voilou.nl" /etc/postfix/virtual
Modifier un alias existant
Cas 1: Changer la destination d’un alias
Exemple: Les emails de support@apsi.net vont actuellement à support, mais vous voulez qu’ils aillent à pchevalier.
# 1. Éditer le fichier
nano /etc/postfix/virtual
# 2. Modifier la ligne:
# Avant: support@apsi.net support
# Après: support@apsi.net pchevalier
# 3. Recompiler et recharger
postmap /etc/postfix/virtual
systemctl reload postfix
# 4. Tester
postmap -q "support@apsi.net" hash:/etc/postfix/virtual
# Doit retourner: pchevalier
# 5. Les nouveaux emails iront dans /home/pchevalier/Maildir/
# Les anciens emails restent dans /home/support/Maildir/
Important: Si vous voulez déplacer les anciens emails:
# Déplacer les emails de l'ancien vers le nouveau compte
cp -r /home/support/Maildir/* /home/pchevalier/Maildir/
chown -R pchevalier:pchevalier /home/pchevalier/Maildir/
Cas 2: Changer l’adresse email (renommer)
Exemple: Renommer support@apsi.net en assistance@apsi.net
# 1. Éditer le fichier
nano /etc/postfix/virtual
# 2. Modifier la ligne:
# Avant: support@apsi.net support
# Après: assistance@apsi.net support
# 3. Recompiler et recharger
postmap /etc/postfix/virtual
systemctl reload postfix
# 4. Informer les utilisateurs du changement d'adresse
# 5. Optionnel: Garder l'ancien alias temporairement
echo "support@apsi.net support" >> /etc/postfix/virtual
postmap /etc/postfix/virtual
systemctl reload postfix
Cas 3: Rediriger vers plusieurs comptes
Exemple: Les emails de info@apsi.net doivent aller à pchevalier ET contact
# 1. Éditer le fichier
nano /etc/postfix/virtual
# 2. Ajouter/modifier la ligne:
info@apsi.net pchevalier,contact
# 3. Recompiler et recharger
postmap /etc/postfix/virtual
systemctl reload postfix
# 4. Les emails seront dupliqués dans les deux boîtes
Cas 4: Changer le mot de passe d’un compte avec alias
Si vous avez: contact@apsi.net → contact
# Le mot de passe est celui du compte Unix 'contact'
# Pour le changer:
# Méthode 1: Interactive
passwd contact
# Méthode 2: Non-interactive
echo "contact:NouveauMotDePasse" | chpasswd
# L'alias n'a pas besoin d'être modifié
# Seul le mot de passe IMAP/SMTP change
Supprimer un alias
# Éditer le fichier et supprimer la ligne
nano /etc/postfix/virtual
# Recompiler et recharger
postmap /etc/postfix/virtual
systemctl reload postfix
# Optionnel: Supprimer l'utilisateur Unix
userdel -r support # -r supprime aussi le home directory
Renommer un Compte Existant (Changement de Convention de Nommage)
Contexte
Si vous avez plusieurs domaines qui ne diffèrent que par le suffixe (ex: apsi.net, apsi.fr, apsi.com) ou si vous voulez clarifier l’appartenance d’un compte à un domaine spécifique, il est préférable d’utiliser une convention de nommage avec le domaine complet dans le nom Unix.
Anciennes conventions: - pchevalier (implicitement pour apsi.net) - pchevalier-voilou (avec tiret)
Nouvelles conventions recommandées: - pchevalier.apsi (notation courte avec point) - pchevalier.apsi.net (notation complète - RECOMMANDÉ) - pchevalier.voilou.nl (notation complète)
Avantages de la notation avec point: - ✅ Clarté: on sait immédiatement à quel domaine appartient le compte - ✅ Évolutivité: permet de gérer des domaines qui ne diffèrent que par le suffixe - ✅ Standard: les points sont autorisés dans les noms Unix modernes - ✅ Cohérence: structure hiérarchique naturelle (utilisateur.domaine.tld)
Procédure de Renommage d’un Compte Existant
Cette procédure montre comment renommer pchevalier en pchevalier.apsi.net.
ÉTAPE 1: Arrêter les services (temporairement)
# Arrêter Dovecot et Postfix pour éviter les conflits
systemctl stop dovecot postfix
Note: Cette étape n’est PAS obligatoire mais recommandée pour éviter tout conflit pendant la migration. Les emails entrants seront temporairement mis en queue sur le serveur backup (ovh2).
ÉTAPE 2: Renommer le compte Unix
# Renommer l'utilisateur (login)
usermod -l pchevalier.apsi.net pchevalier
# Renommer le groupe (optionnel mais recommandé)
groupmod -n pchevalier.apsi.net pchevalier
# Déplacer et renommer le home directory
usermod -d /home/pchevalier.apsi.net -m pchevalier.apsi.net
# Vérifier que tout est correct
id pchevalier.apsi.net
ls -ld /home/pchevalier.apsi.net/
Résultat attendu:
uid=1000(pchevalier.apsi.net) gid=1000(pchevalier.apsi.net) groups=1000(pchevalier.apsi.net) drwxr-xr-x 5 pchevalier.apsi.net pchevalier.apsi.net 4096 Jan 2 10:00 /home/pchevalier.apsi.net/
ÉTAPE 3: Vérifier le Maildir
# Vérifier que le Maildir a été déplacé avec le home
ls -ld /home/pchevalier.apsi.net/Maildir/
# Vérifier les permissions
ls -l /home/pchevalier.apsi.net/Maildir/
# Tout doit appartenir à pchevalier.apsi.net:pchevalier.apsi.net
# Si les permissions sont incorrectes:
chown -R pchevalier.apsi.net:pchevalier.apsi.net /home/pchevalier.apsi.net/Maildir/
chmod -R 700 /home/pchevalier.apsi.net/Maildir/
ÉTAPE 4: Mettre à jour les alias virtuels Postfix
# Éditer le fichier virtual
nano /etc/postfix/virtual
# Modifier la ligne:
# Avant: pchevalier@apsi.net pchevalier
# Après: pchevalier@apsi.net pchevalier.apsi.net
# Ou avec sed:
sed -i 's/pchevalier@apsi.net[[:space:]]*pchevalier$/pchevalier@apsi.net pchevalier.apsi.net/' /etc/postfix/virtual
# Vérifier le changement
grep "pchevalier@apsi.net" /etc/postfix/virtual
Résultat attendu dans /etc/postfix/virtual:
# Domaine apsi.net pchevalier@apsi.net pchevalier.apsi.net contact@apsi.net contact # Domaine voilou.nl pchevalier@voilou.nl pchevalier.voilou.nl contact@voilou.nl contact-voilou
ÉTAPE 5: Recompiler et redémarrer les services
# Recompiler la table virtuelle
postmap /etc/postfix/virtual
# Vérifier la syntaxe Postfix
postfix check
# Redémarrer les services
systemctl start postfix dovecot
# Vérifier que les services sont actifs
systemctl status postfix dovecot
ÉTAPE 6: Tester le mapping
# Tester que l'alias fonctionne
postmap -q "pchevalier@apsi.net" hash:/etc/postfix/virtual
# Doit retourner: pchevalier.apsi.net
ÉTAPE 7: Tester l’authentification
# Tester l'authentification IMAP avec le nouveau nom
doveadm auth test pchevalier.apsi.net MotDePasse
# Doit retourner:
# passdb: pchevalier.apsi.net auth succeeded
# userdb: pchevalier.apsi.net
ÉTAPE 8: Tester la réception d’email
# Envoyer un email de test
echo "Test après renommage du compte" | sendmail pchevalier@apsi.net
# Vérifier la réception dans le nouveau Maildir
ls -lth /home/pchevalier.apsi.net/Maildir/new/
# Vérifier les logs
tail -20 /var/log/mail.log | grep "pchevalier@apsi.net"
Résultat attendu dans les logs:
postfix/local[12345]: ... to=<pchevalier@apsi.net>, relay=local, ... status=sent (delivered to maildir)
ÉTAPE 9: Mettre à jour les clients email (Thunderbird, etc.)
Important: Les clients devront utiliser le nouveau nom Unix pour se connecter!
Dans Thunderbird:
- Méthode 1: Modifier le compte existant
- Ouvrir: Paramètres du compte → Paramètres serveur
- Modifier “Nom d’utilisateur”:
pchevalier→pchevalier.apsi.net - Répéter pour le serveur sortant (SMTP)
- Sauvegarder
- Méthode 2: Créer un nouveau compte (si modification ne fonctionne pas)
- Supprimer l’ancien compte (les emails locaux sont conservés)
- Créer un nouveau compte avec:
- Utilisateur IMAP:
pchevalier.apsi.net - Utilisateur SMTP:
pchevalier.apsi.net - Mot de passe: (inchangé)
- Utilisateur IMAP:
- Les emails seront re-synchronisés depuis le serveur
Dans Roundcube:
Aucune configuration à faire dans Roundcube lui-même, mais l’utilisateur devra se connecter avec: - Utilisateur: pchevalier.apsi.net (au lieu de pchevalier) - Mot de passe: (inchangé)
Exemple Complet: Renommer pchevalier-voilou en pchevalier.voilou.nl
# 1. Arrêter les services
systemctl stop dovecot postfix
# 2. Renommer le compte Unix
usermod -l pchevalier.voilou.nl pchevalier-voilou
groupmod -n pchevalier.voilou.nl pchevalier-voilou
usermod -d /home/pchevalier.voilou.nl -m pchevalier.voilou.nl
# 3. Vérifier
id pchevalier.voilou.nl
ls -ld /home/pchevalier.voilou.nl/Maildir/
# 4. Mettre à jour l'alias
nano /etc/postfix/virtual
# Modifier: pchevalier@voilou.nl pchevalier.voilou.nl
# Ou avec sed:
sed -i 's/pchevalier@voilou.nl[[:space:]]*pchevalier-voilou$/pchevalier@voilou.nl pchevalier.voilou.nl/' /etc/postfix/virtual
# 5. Recompiler et redémarrer
postmap /etc/postfix/virtual
postfix check
systemctl start postfix dovecot
# 6. Tester
postmap -q "pchevalier@voilou.nl" hash:/etc/postfix/virtual
# Doit retourner: pchevalier.voilou.nl
doveadm auth test pchevalier.voilou.nl MotDePasse
echo "Test" | sendmail pchevalier@voilou.nl
ls /home/pchevalier.voilou.nl/Maildir/new/
Cas d’Usage: Domaines ne Différant que par le Suffixe
Si vous gérez plusieurs domaines qui partagent le même nom mais diffèrent par le TLD: - pchevalier@apsi.net - pchevalier@apsi.fr - pchevalier@apsi.com
Avec l’ancienne convention (impossible):
# Impossible de distinguer! pchevalier@apsi.net pchevalier pchevalier@apsi.fr pchevalier # Conflit! pchevalier@apsi.com pchevalier # Conflit!
Avec la nouvelle convention (notation complète):
# Chaque domaine a son propre compte Unix pchevalier@apsi.net pchevalier.apsi.net pchevalier@apsi.fr pchevalier.apsi.fr pchevalier@apsi.com pchevalier.apsi.com
Création des comptes:
# Créer les 3 comptes avec notation complète
useradd -m -s /bin/bash pchevalier.apsi.net
useradd -m -s /bin/bash pchevalier.apsi.fr
useradd -m -s /bin/bash pchevalier.apsi.com
# Définir les mots de passe
echo "pchevalier.apsi.net:Pass1" | chpasswd
echo "pchevalier.apsi.fr:Pass2" | chpasswd
echo "pchevalier.apsi.com:Pass3" | chpasswd
# Créer les Maildir
su - pchevalier.apsi.net -c "maildirmake ~/Maildir"
su - pchevalier.apsi.fr -c "maildirmake ~/Maildir"
su - pchevalier.apsi.com -c "maildirmake ~/Maildir"
# Ajouter les alias
cat >> /etc/postfix/virtual << EOF
# Domaine apsi.net
pchevalier@apsi.net pchevalier.apsi.net
# Domaine apsi.fr
pchevalier@apsi.fr pchevalier.apsi.fr
# Domaine apsi.com
pchevalier@apsi.com pchevalier.apsi.com
EOF
# Recompiler et recharger
postmap /etc/postfix/virtual
systemctl reload postfix
Résultat: Chaque domaine a sa propre boîte mail complètement indépendante.
Notation Courte vs Notation Complète
Notation courte (ex: pchevalier.apsi): - ✅ Plus court à taper - ✅ Suffisant si vous n’avez pas plusieurs TLD pour le même domaine - ⚠️ Moins explicite
Notation complète (ex: pchevalier.apsi.net) - RECOMMANDÉ: - ✅ Totalement explicite - ✅ Permet de gérer plusieurs TLD (apsi.net, apsi.fr, etc.) - ✅ Plus facile à identifier dans les logs et les listes de comptes - ✅ Convention standard pour les services multi-domaines - ⚠️ Légèrement plus long
Recommandation: Utilisez toujours la notation complète (utilisateur.domaine.tld) pour éviter toute ambiguïté future.
Migration Groupée (Script)
Si vous avez plusieurs comptes à renommer, créer un script /root/scripts/rename-accounts.sh:
#!/bin/bash
###############################################################################
# Script de migration vers la nouvelle convention de nommage
# Usage: ./rename-accounts.sh
###############################################################################
echo "=== Migration vers notation avec points ==="
echo ""
# Liste des migrations à effectuer
# Format: "ancien_nom:nouveau_nom:email"
MIGRATIONS=(
"pchevalier:pchevalier.apsi.net:pchevalier@apsi.net"
"pchevalier-voilou:pchevalier.voilou.nl:pchevalier@voilou.nl"
"contact:contact.apsi.net:contact@apsi.net"
"contact-voilou:contact.voilou.nl:contact@voilou.nl"
)
# Arrêter les services
echo "1. Arrêt des services..."
systemctl stop dovecot postfix
echo " ✓ Services arrêtés"
echo ""
# Pour chaque migration
for migration in "${MIGRATIONS[@]}"; do
OLD_NAME=$(echo $migration | cut -d: -f1)
NEW_NAME=$(echo $migration | cut -d: -f2)
EMAIL=$(echo $migration | cut -d: -f3)
echo "=== Migration: $OLD_NAME → $NEW_NAME ==="
# Vérifier que l'ancien compte existe
if ! id "$OLD_NAME" &>/dev/null; then
echo " ⚠ Compte $OLD_NAME n'existe pas, skip"
echo ""
continue
fi
# Renommer l'utilisateur
echo " - Renommage de l'utilisateur..."
usermod -l "$NEW_NAME" "$OLD_NAME"
# Renommer le groupe
echo " - Renommage du groupe..."
groupmod -n "$NEW_NAME" "$OLD_NAME" 2>/dev/null || true
# Déplacer le home directory
echo " - Déplacement du home directory..."
usermod -d "/home/$NEW_NAME" -m "$NEW_NAME"
# Fixer les permissions
echo " - Correction des permissions..."
chown -R "$NEW_NAME:$NEW_NAME" "/home/$NEW_NAME/Maildir/" 2>/dev/null || true
# Mettre à jour l'alias virtuel
echo " - Mise à jour de l'alias Postfix..."
sed -i "s|^$EMAIL[[:space:]]*$OLD_NAME$|$EMAIL $NEW_NAME|" /etc/postfix/virtual
echo " ✓ Migration terminée: $OLD_NAME → $NEW_NAME"
echo ""
done
# Recompiler la table virtuelle
echo "2. Recompilation de la table virtuelle..."
postmap /etc/postfix/virtual
postfix check
echo " ✓ Table virtuelle recompilée"
echo ""
# Redémarrer les services
echo "3. Redémarrage des services..."
systemctl start postfix dovecot
systemctl status postfix dovecot --no-pager -l
echo " ✓ Services redémarrés"
echo ""
# Afficher le résumé
echo "=== RÉSUMÉ DES MIGRATIONS ==="
echo ""
for migration in "${MIGRATIONS[@]}"; do
OLD_NAME=$(echo $migration | cut -d: -f1)
NEW_NAME=$(echo $migration | cut -d: -f2)
EMAIL=$(echo $migration | cut -d: -f3)
if id "$NEW_NAME" &>/dev/null; then
echo "✓ $EMAIL → $NEW_NAME"
else
echo "✗ $EMAIL → échec de migration"
fi
done
echo ""
echo "=== TESTS ==="
echo ""
for migration in "${MIGRATIONS[@]}"; do
EMAIL=$(echo $migration | cut -d: -f3)
EXPECTED=$(echo $migration | cut -d: -f2)
RESULT=$(postmap -q "$EMAIL" hash:/etc/postfix/virtual)
if [ "$RESULT" == "$EXPECTED" ]; then
echo "✓ $EMAIL → $RESULT"
else
echo "✗ $EMAIL → $RESULT (attendu: $EXPECTED)"
fi
done
echo ""
echo "=== MIGRATION TERMINÉE ==="
echo ""
echo "IMPORTANT: Les utilisateurs devront mettre à jour leurs clients email:"
echo " - Thunderbird: Modifier le 'Nom d'utilisateur' dans les paramètres du compte"
echo " - Roundcube: Se connecter avec le nouveau nom d'utilisateur"
echo ""
echo "Anciens noms → Nouveaux noms:"
for migration in "${MIGRATIONS[@]}"; do
OLD_NAME=$(echo $migration | cut -d: -f1)
NEW_NAME=$(echo $migration | cut -d: -f2)
echo " - $OLD_NAME → $NEW_NAME"
done
Utilisation du script:
# 1. Adapter les migrations dans le script
nano /root/scripts/rename-accounts.sh
# 2. Rendre le script exécutable
chmod +x /root/scripts/rename-accounts.sh
# 3. Faire un backup (IMPORTANT!)
tar -czf /backup/mail-accounts-$(date +%Y%m%d).tar.gz /home/*/Maildir/ /etc/postfix/virtual
# 4. Exécuter le script
/root/scripts/rename-accounts.sh
# 5. Vérifier les résultats
cat /etc/postfix/virtual | grep -v "^#" | grep "@"
ls -ld /home/*.*/
CHECKLIST DE VALIDATION
Après le renommage d’un compte:
Système Unix
- ☐ Ancien compte n’existe plus:
id pchevalierretourne une erreur - ☐ Nouveau compte existe:
id pchevalier.apsi.netretourne les infos - ☐ Home directory déplacé:
/home/pchevalier.apsi.net/existe - ☐ Maildir intact:
/home/pchevalier.apsi.net/Maildir/contient les emails - ☐ Permissions correctes:
ls -l /home/pchevalier.apsi.net/Maildir/
Configuration Postfix
- ☐ Alias mis à jour dans
/etc/postfix/virtual - ☐ Table virtuelle recompilée:
postmap /etc/postfix/virtualexécuté - ☐ Mapping correct:
postmap -q "pchevalier@apsi.net" hash:/etc/postfix/virtualretourne le nouveau nom - ☐ Postfix actif:
systemctl status postfix
Configuration Dovecot
- ☐ Dovecot actif:
systemctl status dovecot - ☐ Authentification fonctionne:
doveadm auth test pchevalier.apsi.net MotDePasse
Tests Fonctionnels
- ☐ Email de test envoyé:
echo "Test" | sendmail pchevalier@apsi.net - ☐ Email reçu:
ls /home/pchevalier.apsi.net/Maildir/new/ - ☐ Logs corrects:
grep "pchevalier@apsi.net" /var/log/mail.log
Clients Email
- ☐ Thunderbird: Nom d’utilisateur mis à jour en
pchevalier.apsi.net - ☐ Connexion IMAP réussie
- ☐ Envoi d’email réussi
- ☐ Réception d’email réussie
DÉPANNAGE
Erreur: “User unknown”
Cause: L’ancien nom Unix est encore dans /etc/postfix/virtual
Solution:
# Vérifier l'alias
grep "pchevalier@apsi.net" /etc/postfix/virtual
# Devrait montrer: pchevalier@apsi.net pchevalier.apsi.net
# Si ce n'est pas le cas, corriger:
nano /etc/postfix/virtual
# Recompiler
postmap /etc/postfix/virtual
systemctl reload postfix
Erreur: “Authentication failed” dans Thunderbird
Cause: Thunderbird utilise encore l’ancien nom Unix
Solution:
# Dans Thunderbird:
# 1. Paramètres du compte → Paramètres serveur
# 2. Modifier "Nom d'utilisateur": pchevalier → pchevalier.apsi.net
# 3. Répéter pour le serveur sortant (SMTP)
# 4. Redémarrer Thunderbird
Erreur: “Maildir does not exist”
Cause: Le Maildir n’a pas été déplacé correctement
Solution:
# Vérifier où est le Maildir
find /home -name "Maildir" -type d
# Si encore dans l'ancien emplacement:
mv /home/pchevalier/Maildir /home/pchevalier.apsi.net/
chown -R pchevalier.apsi.net:pchevalier.apsi.net /home/pchevalier.apsi.net/Maildir/
Les anciens emails ne sont pas visibles
Cause: Permissions incorrectes sur le Maildir
Solution:
# Fixer les permissions récursivement
chown -R pchevalier.apsi.net:pchevalier.apsi.net /home/pchevalier.apsi.net/Maildir/
chmod -R 700 /home/pchevalier.apsi.net/Maildir/
# Forcer Dovecot à re-scanner
doveadm force-resync -u pchevalier.apsi.net '*'
Gestion des Mots de Passe
Changer le mot de passe d’un compte
# Méthode 1: Interactive
passwd support
# Méthode 2: Non-interactive
echo "support:NouveauMotDePasse" | chpasswd
# Méthode 3: Demander à l'utilisateur de le changer
passwd -e support # Force le changement au prochain login
Note: Le mot de passe Unix est utilisé pour l’authentification IMAP/SMTP.
Gestion des Quotas (Optionnel)
Limiter la taille de la boîte mail
# Installer les outils de quota
apt install quota
# Définir un quota de 1GB pour un utilisateur
setquota -u support 1000000 1100000 0 0 /home
# Vérifier le quota
quota -u support
Note: Les quotas nécessitent une configuration avancée du système de fichiers. Pas configuré par défaut.
CHECKLIST DE VALIDATION
Création du compte
- ☐ Utilisateur Unix créé avec
useradd -m - ☐ Mot de passe défini avec
passwdouchpasswd - ☐ Maildir créé dans
/home/utilisateur/Maildir/ - ☐ Permissions correctes (propriétaire = utilisateur)
Configuration Postfix
- ☐ Alias ajouté dans
/etc/postfix/virtual - ☐
postmap /etc/postfix/virtualexécuté - ☐
postfix checkne retourne pas d’erreurs - ☐
systemctl reload postfixexécuté - ☐ Mapping testé avec
postmap -q
Tests
- ☐ Email de test envoyé localement
- ☐ Email reçu dans le Maildir
- ☐ Logs montrent
status=sent (delivered to maildir) - ☐ Signature DKIM présente (vérifier logs:
grep DKIM /var/log/mail.log)
Configuration Client
- ☐ Thunderbird configuré avec nom Unix (pas email)
- ☐ Connexion IMAP/SMTP réussie
- ☐ Email envoyé depuis le client
- ☐ Email reçu sur le client
DÉPANNAGE
Erreur: “User unknown in local recipient table”
Cause: L’alias n’est pas dans /etc/postfix/virtual ou pas compilé.
Solution:
# Vérifier que l'alias existe
grep "support@apsi.net" /etc/postfix/virtual
# Recompiler et recharger
postmap /etc/postfix/virtual
systemctl reload postfix
Erreur: “Maildir does not exist”
Cause: Le Maildir n’a pas été créé pour l’utilisateur.
Solution:
# Créer manuellement
su - support -c "maildirmake ~/Maildir"
# Vérifier
ls -ld /home/support/Maildir/
Email non reçu dans Thunderbird
Causes possibles:
Mauvais nom d’utilisateur:
- ❌ Utilisé:
support@apsi.net - ✅ Correct:
support
- ❌ Utilisé:
Mauvais mot de passe:
# Tester l'authentification doveadm auth test support MotDePasse
Certificat SSL:
- Vérifier que vous utilisez
mail.apsi.net(pas l’IP) - Vérifier que STARTTLS est activé
- Vérifier que vous utilisez
Impossible de se connecter avec le nouveau compte
# 1. Vérifier que l'utilisateur existe
id support
# 2. Vérifier le mot de passe
doveadm auth test support MotDePasse
# 3. Vérifier les logs Dovecot
grep "auth failed" /var/log/mail.log | tail -20
# 4. Tester IMAP manuellement
telnet localhost 143
a1 LOGIN support MotDePasse
a2 LOGOUT
Email envoyé mais pas dans le Maildir
# 1. Vérifier les logs
tail -50 /var/log/mail.log | grep "support@apsi.net"
# 2. Vérifier la queue
mailq
# 3. Vérifier les permissions du Maildir
ls -ld /home/support/Maildir/
# Doit être: drwx------ support support
# 4. Corriger les permissions si nécessaire
chown -R support:support /home/support/Maildir/
chmod -R 700 /home/support/Maildir/
COMMANDES UTILES
Lister tous les comptes email
# Lister tous les utilisateurs avec un Maildir
find /home -maxdepth 2 -type d -name "Maildir" | sed 's|/Maildir||' | sed 's|/home/||'
Lister tous les alias configurés
# Voir tous les alias virtuels
cat /etc/postfix/virtual | grep -v "^#" | grep "@"
Statistiques d’une boîte mail
# Nombre d'emails dans la boîte
find /home/support/Maildir/cur/ -type f | wc -l
find /home/support/Maildir/new/ -type f | wc -l
# Taille de la boîte mail
du -sh /home/support/Maildir/
Sauvegarder une boîte mail
# Backup d'un compte spécifique
tar -czf /backup/support-mail-$(date +%Y%m%d).tar.gz /home/support/Maildir/
# Restaurer
tar -xzf /backup/support-mail-20260102.tar.gz -C /
chown -R support:support /home/support/Maildir/
SCRIPT AUTOMATISÉ
Script pour ajouter rapidement un compte
Créer /root/scripts/add-email-account.sh:
#!/bin/bash
# Usage: ./add-email-account.sh email@domaine.com nom-unix motdepasse
if [ $# -ne 3 ]; then
echo "Usage: $0 email@domaine.com nom-unix motdepasse"
echo "Exemple: $0 support@apsi.net support MonMotDePasse123"
exit 1
fi
EMAIL=$1
USERNAME=$2
PASSWORD=$3
echo "=== Ajout du compte $EMAIL ==="
# 1. Créer l'utilisateur
echo "1. Création de l'utilisateur $USERNAME..."
useradd -m -s /bin/bash $USERNAME
echo "$USERNAME:$PASSWORD" | chpasswd
# 2. Créer le Maildir
echo "2. Création du Maildir..."
su - $USERNAME -c "maildirmake ~/Maildir"
# 3. Ajouter l'alias
echo "3. Ajout de l'alias dans Postfix..."
echo "$EMAIL $USERNAME" >> /etc/postfix/virtual
postmap /etc/postfix/virtual
systemctl reload postfix
# 4. Tester
echo "4. Test du mapping..."
RESULT=$(postmap -q "$EMAIL" hash:/etc/postfix/virtual)
if [ "$RESULT" == "$USERNAME" ]; then
echo "✓ Mapping OK: $EMAIL -> $RESULT"
else
echo "✗ Erreur de mapping!"
exit 1
fi
# 5. Test d'envoi
echo "5. Envoi d'un email de test..."
echo "Bienvenue! Votre compte email $EMAIL est maintenant actif." | sendmail $EMAIL
echo ""
echo "=== Compte créé avec succès! ==="
echo "Email: $EMAIL"
echo "Nom d'utilisateur IMAP/SMTP: $USERNAME"
echo "Mot de passe: $PASSWORD"
echo ""
echo "Configuration Thunderbird:"
echo " - Serveur: mail.apsi.net"
echo " - Utilisateur: $USERNAME"
echo " - Port IMAP: 143 (STARTTLS)"
echo " - Port SMTP: 587 (STARTTLS)"
Utilisation du script
# Rendre le script exécutable
chmod +x /root/scripts/add-email-account.sh
# Utiliser le script
/root/scripts/add-email-account.sh support@apsi.net support MotDePasseSecurise123!
# Vérifier
ls /home/support/Maildir/new/
RÉCAPITULATIF
Pour ajouter un compte email:
- Créer l’utilisateur Unix :
useradd -m -s /bin/bash nom - Définir le mot de passe :
echo "nom:pass" | chpasswd - Créer le Maildir :
su - nom -c "maildirmake ~/Maildir" - Ajouter l’alias :
echo "email@domaine.com nom" >> /etc/postfix/virtual - Compiler et recharger :
postmap /etc/postfix/virtual && systemctl reload postfix - Tester :
postmap -q "email@domaine.com" hash:/etc/postfix/virtual
Configuration DNS
Aucune modification DNS nécessaire! Le domaine est déjà configuré avec SPF, DKIM et DMARC.
Configuration serveur relay (OVH2)
Aucune modification nécessaire! Le domaine est déjà dans relay_domains.
Guide créé le: 02 Janvier 2026 Auteur: Configuration Claude + PC Serveur: ovh1 (mail.apsi.net)