About nc-userimporter

This tool creates Nextcloud users from a CSV file, which you exported from some other software or created with a spreadsheet software.

Zip files with executables for Windows, MacOS, Linux available here: https://get.edudocs.org/de/assets/nc-userimporter/ - If you have a Python3 environment with all the dependencies/modules installed, you can run the script without the build of course.

Screenshot input:

Instructions

1. Download and extract the zip-file for your operating system from https://get.edudocs.org/de/assets/nc-userimporter/

2. Insert data:

   • config.xml: Insert your cloud-admin credentials into file config.xml. The user must have admin permissions in your Nextcloud.
   • users.csv: Insert the user data into the file users.csv or recreate it with the same columns in a spreadsheet software. (Specified groups must already exist!)

   Avoid special characters in username and password (including german umlauts) or test if the character is allowed first.

3. Start the tool:

   • Windows: doubleclick nc-userimporter.exe. (built and tested with Win10 Pro 1803 64-bit)
   • Linux: doubleclick nc-userimporter or via terminal: change to the app-directory and execute: ./nc-userimporter (built and tested with Ubuntu 16.04 x86_64; tested with Fedora 29 x86_64, openSUSE Leap 15.0 x86_64, Arch) Troubleshooting: Make sure the file is executable (https://www.qwant.com/?q=make%20file%20executable%20linux)
   • Mac: doubleclick nc-userimporter. Answer the prompt with "open", ignore the warning. (built and tested with macOS 10.12 Sierra) Troubleshooting: Make sure the file is executable (https://www.qwant.com/?q=make%20file%20executable%20mac)

4. Follow the interactive commandline instructions. Check output.log and your user overview in Nextcloud.

Output

Screenshot output:

---

ToDo

• improve documentation of features https://github.com/t-markmann/nc-userimporter/wiki#todo-documentation
• refactoring / clean code

Open features, not yet implemented (help appreciated):

• Passwords with special characters not supported?
• Accept self-signed certificates, with a warning for the user. Like: cloudfoundry-community/cf-python-client#51 (comment)
• read config from CLI-input if config-file is empty; update config.xml with input values?
• ask if users exists first: https://docs.nextcloud.com/server/15/admin_manual/configuration_user/instruction_set_for_users.html
• add language (not necessary because of default/browser language?)
• add other userdata