Managing accounts

Each account/user is identified by an e-mail address. This applies for the management of accounts and for all user logins. Internally each account is identified by its unique UID.

Creating an account

Syntax:

• vmm useradd address [password]
  vmm ua address [password]

Use this subcommand to create a new email account for the given address. If no password is provided, vmm will prompt for it interactively.

Examples:

hostname ~ # vmm useradd jane.doe@example.com
Enter new password:
Retype new password:
hostname ~ # vmm ua judy.roe@example.com a2sd54g4h
hostname ~ #

Account information

Syntax:

• vmm userinfo address [details]
  vmm ui address [details]

This subcommand displays some information about the account specified by address. If the optional argument details is given some more information will be displayed.
Possible values for details are:

aliases

to list all alias addresses with the destination address

du

to display the disk usage of users maildir

full

to list all information mentioned above

Example¹:

hostname ~ # vmm userinfo john.doe@example.com aliases
Account information
-------------------
        Address........: john.doe@example.com
        Name...........: John Doe
        UID............: 79801
        GID............: 70312
        Transport......: dovecot:
        Maildir........: /srv/mail/8/70312/79801/Maildir
        SMTP...........: disabled
        POP3...........: enabled
        IMAP...........: enabled
        SIEVE..........: disabled

Available alias addresses
-------------------------
        None

hostname ~ #

Setting a real name

Syntax:

• vmm username address 'Users Name'
  vmm un address 'Users Name'

The user's real name can be set/updated with this subcommand.

Example:

hostname ~ # vmm username jane.doe@example.com 'Jane Doe'
hostname ~ #

Changing the password

Syntax:

• vmm userpassword address [password]
  vmm up address [password]

The password from an account can be updated with this subcommand. If the password is not provided, vmm will prompt for it interactively.

Example:

hostname ~ # vmm userpassword judy.roe@example.com
Enter new password:
Retype new password:
hostname ~ #

Modifying the transport

Syntax:

• vmm usertransport address transport
  vmm ut address transport

An alternative transport for an account can be specified with this subcommand.

Example:

hostname ~ # vmm usertransport john.doe@example.com smtp:pc123.pool.example.com
hostname ~ #

Disabling services

Syntax:

• vmm userdisable address [service]
  vmm u0 address [service]

If a user shouldn't have access to one or all services you can restrict the access with this subcommand.
If neither a service nor the keyword all is given all services (smtp, pop3, imap, and sieve) will be disabled for the account with the specified address. Otherwise only the specified service will be restricted.

Example:

hostname ~ # vmm userdisable jane.doe@example.com imap
hostname ~ #

Enabling services

Syntax:

• vmm userenable address [service]
  vmm u1 address [service]

To allow access to one or all restricted services use this subcommand.
If neither a service nor the keyword all is given all services (smtp, pop3, imap, and sieve) will be enabled for the account with the specified address. Otherwise only the specified service will be enabled.

Example:

hostname ~ # vmm userenable judy.roe@example.com sieve
hostname ~ #

Deleting an account

Syntax:

• vmm userdelete address [delalias]
  vmm ud address [delalias]

Use this subcommand to delete the account with the given address.
If there are one or more aliases with an identical destination address, vmm will abort the requested operation and show an error message. To prevent this, specify the optional keyword delalias, vmm will then remove the destination address from those affected aliases.

Example:

hostname ~ # vmm userdelete john.doe@example.com
hostname ~ #