Change attributes of a mail, FTP or database user
After a user has been created from the command line or web interface, you can use this program to modify or rename him. The virtual server and user to change must be specified with the
--user parameters, which are followed by the server domain name and username respectively.
To change the user's password, use the
--pass parameter followed by the new password. To modify his real name, use the
--real option followed by the new name (which must typically be quoted, in case it contains a space). If you want to change the user's login name, use the
--newuser option, followed by the new short username (without a suffix).
A user can be temporarily disabled with the
--disable option, or re-enabled with the
--enable option. This will not effect his files or password, but will prevent FTP, IMAP and other logins.
To set the user's disk quota, the
--quota option must be used, followed by the disk quota in 1 kB blocks. An unlimited quota can be set with the parameters
--quota UNLIMITED instead (although of course the user will still be limited by total server quotas).
A user can be granted or denied FTP access with the
--disable-ftp options respectively. Similarly, the primary email address can be turned on or off with the
Extra email addresses can be added and removed with the
--remove-email options. Both of these must be followed by an address to add or remove, and both can occur multiple times on the command line.
Access to MySQL databases in the domain can be granted with the
--add-mysql flag, followed by a database name. Similarly, access can be removed with the
To turn off spam checking for the user, the
--no-check-spam flag can be given. This is useful for mailboxes that are supposed to receive all the spam for some domain. To turn spam filtering back on, use the
--check-spam command-line flag.
The user can also be added to secondary Unix groups with the
--add-group flag, followed by a group name. To remove him from a group, use the
--del-group parameter followed by the group to take him out of.
To add a forwarding email address for this user, use the
--add-forward flag followed by an address or username. Conversely, to remove one use the
To turn off local email delivery for the user, use the
--no-local flag. To turn it back on again, use
To setup an autoreply message, use the
--autoreply flag followed by the message content. To turn off the autoresponder, use the
To control when the autoreply is sent, use the
--autoreply-start flag followed by a date in YYYY-MM-DD format, like 2010-04-01. To set the date on which is stops being sent, use the
--autoreply-end flag. To limit the rate of replies to the same address, use the
--autoreply-period flag followed by a number in minutes.
Command Line Help
virtualmin modify-user --domain domain.name --user username [--pass new-password | --passfile password-file] [--disable | --enable] [--real real-name] [--quota quota-in-blocks] [--add-mysql database] [--remove-mysql database] [--enable-email] [--disable-email] [--add-email address] [--remove-email address] [--newuser new-username] [--enable-ftp] [--disable-ftp] [--add-group group]* [--del-group group]* [--send-update-email] [--no-check-spam | --check-spam] [--add-forward address]* [--del-forward address]* [--local | --no-local] [--autoreply "messsage" | --no-autoreply] [--autoreply-start time | --no-autoreply-start] [--autoreply-end time | --no-autoreply-end] [--autoreply-period secs | --no-autoreply-period]