🚀 Importer des utilisateurs en masse dans Nextcloud via CSV, groupes compris (édition shell)

🌐 Aussi en: English · Deutsch · Español

Vous faites tourner une instance Nextcloud et vous voulez créer des utilisateurs en masse, comme un vrai sysadmin ? Voici une solution 100 % shell pour créer des utilisateurs à partir d’un fichier CSV, les affecter à des groupes (même plusieurs) et vous sentir le patron pendant ce temps.

📦 Prérequis

• Un accès SSH à votre serveur Nextcloud
• Un accès en ligne de commande à occ (situé à la racine de votre installation Nextcloud, par ex. /var/www/html/nextcloud)
• Votre fichier CSV, prêt à l’emploi

📄 Format du fichier CSV

Pas d’en-tête, uniquement des données brutes. Format :

username,password,Display Name,Group1;Group2;Group3

Exemple :

next001,secret123,Max Mustermann,Vorstand;Mitglieder
next002,test456,Lisa Beispiel,Trainer
next003,pass789,Peter Test,Trainer;Mitglieder

🛠️ Le script Bash : create_users_with_groups.sh

<#!/bin/bash

CSV_FILE="benutzer.csv"  # Path to your CSV file

cd /var/www/html/nextcloud || exit 1

# Read file line by line
while IFS=',' read -r username password displayname groups_raw; do

    # Skip empty or malformed lines
    if [[ -z "$username" || -z "$password" || -z "$displayname" ]]; then
        echo "⚠️  Skipping invalid or empty line: $username, $displayname"
        continue
    fi

    echo "▶️ Creating user: $username ($displayname)"

    # Export password into environment
    export OC_PASS="$password"

    # Use -E to preserve environment for www-data
    sudo -E -u www-data php occ user:add --password-from-env "$username" --display-name "$displayname"
    USER_EXISTS=$?

    if [ $USER_EXISTS -ne 0 ]; then
        echo "❌ Failed to create user '$username'. Skipping group assignment."
        continue
    fi

    # Split group list on semicolon (;) and trim whitespace
    IFS=';' read -ra groups <<< "$groups_raw" for group in "${groups[@]}"; do group=$(echo "$group" | xargs) # Trim spaces if [ -n "$group" ]; then echo " ➕ Adding $username to group '$group'" # Create group if not already existing (ignore stderr) sudo -u www-data php occ group:add "$group" 2>/dev/null

            # Add user to group
            sudo -u www-data php occ group:adduser "$group" "$username"
        fi
    done

done < "$CSV_FILE"/code>

⚙️ Utilisation

chmod +x create_users_with_groups.sh
./create_users_with_groups.sh

Vérifiez que votre fichier benutzer.csv se trouve dans le même répertoire, ou adaptez le chemin en conséquence.

🔐 Remarques

• Les mots de passe sont transmis de façon sécurisée via des variables d’environnement – ni par la ligne de commande, ni par stdin
• Les groupes sont créés automatiquement s’ils n’existent pas encore
• Le point-virgule (;) sépare plusieurs groupes pour un même utilisateur

🧠 Astuce bonus

Envie de passer en mode automatisation totale ? Intégrez ce script à vos scripts d’onboarding, ou provisionnez vos utilisateurs via LDAP et réservez-le aux comptes spéciaux ou temporaires.

🫡 Succès débloqué : gloire du sysadmin

Et voilà – vos utilisateurs sont en ligne, rangés dans leurs groupes et prêts à nextclouder comme des pros. Vous voulez mettre en place des Group Folders et appliquer des règles de droits ? Faites-moi signe – je me ferai un plaisir d’y plonger en mode geek.