🚀 Gebruikers in bulk importeren in Nextcloud via CSV + groepstoewijzing (shell-editie)

Illustratie: een lachende man zwaait naar avatars die aan parachutes naar een Nextcloud-logo zweven

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

Dus je draait een Nextcloud-instantie en wilt gebruikers in batches aanmaken als een echte sysadmin? Hier is een puur op shell gebaseerde oplossing om gebruikers vanuit een CSV-bestand aan te maken, ze aan groepen toe te wijzen (zelfs aan meerdere) en je daarbij de baas te voelen.

📦 Vereisten

  • SSH-toegang tot je Nextcloud-server
  • Commandlinetoegang tot occ (te vinden in de root van je Nextcloud-installatie, bijv. /var/www/html/nextcloud)
  • Je CSV-bestand klaar voor gebruik

📄 Formaat van het CSV-bestand

Geen headers, alleen pure data. Formaat:

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

Voorbeeld:

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

🛠️ Het Bash-script: 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>

⚙️ Gebruik

chmod +x create_users_with_groups.sh
./create_users_with_groups.sh

Zorg dat je benutzer.csv-bestand in dezelfde map staat, of pas het pad aan.

🔐 Opmerkingen

  • Wachtwoorden worden veilig doorgegeven via omgevingsvariabelen – niet via de commandline of stdin
  • Groepen worden automatisch aangemaakt als ze nog niet bestaan
  • Een puntkomma (;) scheidt meerdere groepen per gebruiker

🧠 Bonustip

Wil je volledig in automatiseringsmodus? Integreer dit in onboardingscripts voor gebruikers, of richt je gebruikers in via LDAP en gebruik dit alleen voor aangepaste of tijdelijke accounts.

🫡 Sysadmin-glorie ontgrendeld

Dat was het – je gebruikers zijn nu live, gegroepeerd en klaar om als pro’s te Nextclouden. Wil je Group Folders opzetten en rechtenregels toepassen? Laat het me weten – daar nerd ik ook graag over.

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details