Info:: apsi.net: GUIDE AJOUT COMPTE

De wiki_pcwiki2
Aller à la navigationAller à la recherche

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:

Email 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:

  1. 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
  2. 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é)
    • 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 pchevalier retourne une erreur
  • ☐ Nouveau compte existe: id pchevalier.apsi.net retourne 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/virtual exécuté
  • ☐ Mapping correct: postmap -q "pchevalier@apsi.net" hash:/etc/postfix/virtual retourne 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 passwd ou chpasswd
  • ☐ Maildir créé dans /home/utilisateur/Maildir/
  • ☐ Permissions correctes (propriétaire = utilisateur)

Configuration Postfix

  • ☐ Alias ajouté dans /etc/postfix/virtual
  • ☐ postmap /etc/postfix/virtual exécuté
  • ☐ postfix check ne retourne pas d’erreurs
  • ☐ systemctl reload postfix exé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:

  1. Mauvais nom d’utilisateur:

    • ❌ Utilisé: support@apsi.net
    • ✅ Correct: support
  2. Mauvais mot de passe:

    # Tester l'authentification
    doveadm auth test support MotDePasse
    
  3. Certificat SSL:

    • Vérifier que vous utilisez mail.apsi.net (pas l’IP)
    • Vérifier que STARTTLS est activé

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:

  1. Créer l’utilisateur Unix : useradd -m -s /bin/bash nom
  2. Définir le mot de passe : echo "nom:pass" | chpasswd
  3. Créer le Maildir : su - nom -c "maildirmake ~/Maildir"
  4. Ajouter l’alias : echo "email@domaine.com nom" >> /etc/postfix/virtual
  5. Compiler et recharger : postmap /etc/postfix/virtual && systemctl reload postfix
  6. 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)