Import Users
You can create user accounts in bulk by importing user lists. Use text editor, such as Notepad, or Microsoft Excel to create user lists.
To create the users list:
Method 1: Use a Text Editor:
- Open a new file with a text editor.
- Enter a user's information in the following order and separate them using a delimiter, i.e., tab, comma, or semicolon:
- Username
- Password
- Description: Enter a description for the user.
- Group name: Enter the name of the group that you want to assign the user to. The default is the users group. If you wish to assign the user to more than one group, use comma to separate the group names and put quotation marks around the group names (e.g., "group1,group2,group3").
- Quota (MB) in volume 1 (repeat this step if you have more than one volume)
Note:
- If you create a user through file import, setting user quota for Btrfs file system or external storage devices (e.g., USB or eSATA drives) is not supported. You can manually set user quota for Btrfs file system after importing user list.
- If your DSM is composed of a combination of ext4 and Btrfs file systems, you can set user quota for ext4 volume by entering a number in the corresponding field and leaving the Btrfs field empty. For example, if Volume 1 and 3 are ext4 volumes and Volume 2 is a Btrfs volume, and you wish to set user quota for rose for Volume 1 and 3, enter:
rose, 111111, Accounting, rose@abc.com, users, 80000, , 60000
- Go to the next line and repeat step 2 until you have entered all the users. Each user's information should be entered in a new row.
- Save the file in UTF-8 encoding.
Method 2: Use Microsoft Excel:
- Open a new file with Excel.
- Enter users' information in the following order and separate them by column in a single row:
- Username
- Password
- Description: Enter a description for the user.
- Group name: Enter the name of the group that you want to assign the user to. The default is the users group. If you wish to assign the user to more than one group, use comma to separate the group names and put quotation marks around the group names (e.g., "group1,group2,group3").
- Quota (MB) in volume 1 (repeat this step if you have more than one volume)
Note:
- If you create a user through file import, setting user quota for Btrfs file system or external storage devices (e.g., USB or eSATA drives) is not supported. You can manually set user quota for Btrfs file system or external storage devices after importing user list.
- If your DSM is composed of a combination of ext4 and Btrfs file systems, you can set user quota for ext4 volume by entering a number in the corresponding field and leaving the Btrfs field empty. Please refer to the table below as an example.
- Go to the next row and repeat step 2 until you have entered all the users. Each user's information should be entered in a new row.
- Save the Excel file in .csv format.
- Open the .csv file you just saved with text editor and save it again in UTF-8 encoding.
Note:
- All fields are optional except username.
- Below is an example of a text file. The header row used here is only for clarification purposes and should not appear in the actual file. Please note that if you are setting user quota for more than one volume, make sure to use separate columns.
Username | Password | Description | Group name | Quota on Volume 1 (ext4 volume) | Quota on Volume 2 (Btrfs volume) | Quota on Volume 3 (ext4 volume) | |
---|---|---|---|---|---|---|---|
rose | 111111 | Accounting | rose@abc.com | users | 80000 | 60000 | |
bobby | 222222 | bobby@abc.com | users | 80000 | 60000 | ||
danny | 333333 | HR | danny@abc.com | users | 60000 | ||
mark | 444444 | IT | mark@abc.com | administrators |
To import the users list:
- Click Create > Import users.
- Tick the following options if you wish to enable them.
- Overwrite duplicate accounts: Tick this option if you wish to replace the duplicate accounts with the one exists in the users list.
- Send a notification mail to the newly created user: Tick this option to have the system send a message to the user notifying him of the new account.
- Display user password in notification mail: This option is available when Send a notification mail to the newly created user is ticked. Tick this option if you wish to display the password in the notification message.
- Force password change for imported users upon initial login: Tick this option if you want to force imported users to change their password upon initial login. Doing so adds extra protection to imported accounts.
- Click Browse and select the file. After the file is selected, the list of imported users will be displayed in the table below. Users with abnormal status will not be imported.
- Select the type of delimiter, i.e., tab, comma, or semicolon, that you used to separate the fields in the list from the Delimiter drop-down menu.
- Click OK to import the user accounts.
Note:
- The users list file must be in UTF-8 format.