Qmail Migration

On the upcoming Uberspace U8 mail system the deprecated qmail configurations from U6 will no longer be available.

Check your configuration

To check now if any of your qmail configurations encounter problems to be used in the standard mail setup, you can use the migration tool:

[isabell@stardust ~]$ uberspace migration qmail status
Error: there are 2 problems with your mail config.

To see more details info run the check command with "uberspace migration qmail check".

The command will help you to identify any problems in your current configuration. You can see more details with the subcommand check:

[isabell@stardust ~]$ uberspace migration qmail check
[...]
.qmail-postmaster
  error: The file contains a username that is not the current user
[...]

Add the --assist flag to see a short info how to fix the problem and a link to the manual with more detailed information and instructions:

[isabell@stardust ~]$ uberspace migration qmail check --assist
[...]
.qmail-postmaster
  error: The file contains a username that is not the current user
  • Remove the qmail file and use "uberspace mail user forward set postmaster mail@example.com"
  • Manual: https://manual.uberspace.de/migration/qmail/reports/content-username-off
[...]

Use --help to see even more options how to use the command.

Error messages

The check command can show you several messages considering your qmail setup. In this list you can find all error messages and more detailed help pages:

• The filename “.qmail-Example” cannot be parsed

• The file is a subaddressing catchall with a “-” delimiter

• The sysmail config file for username@uber.space contains a vdeliver code pipe

• The file contains a code pipe “|” to a custom command

• The file conflicts with an already existing mail user

• The file content is empty

• The file conflicts with an already existing mail user

• The file contains an “|exit 100” code

• The file contains an internal redirect to a mailuser

• The file contains multiple lines which are no mailaddresses

• Retrieving the file content returned a system error

• The file contains a path to a custom mailbox-file

• The file contains a path to the maildir of a non existing mail user

• The maildir path does not point to “~/users/example”

• The file forwards to a non existing mail user “example” and there is no catchall configured

• The file contains unknown content

• The file contains a username that is not the current user

• The file forwards to a non existing mail user “example” and there is no catchall configured

• The content of the main qmail file “~/.qmail-default” is a mailaddress

• The content of the main qmail file “~/.qmail-default” is configured with unknown content

• The content of the main qmail file “~/.qmail-default” is the username

• The main qmail file “~/.qmail-default” does not exist

• The file conflicts with an already existing mail user

• The file conflicts with an already existing mail user

• The script file “~/.spamfolder” for the standard mail setup contains unkown content

• There are mailusers with direct forward to a mailbox

• The mail database file “~/passwd.cdb” seems to be broken