Manage mail addresses¶

Use uberspace mail address to manage everything related to mail: e.g., addresses, forwards, passwords and the system mailbox.

[isabell@moondust ~]$ uberspace mail address

 Usage: uberspace mail address [OPTIONS] COMMAND [ARGS]...

╭─ Commands ──────────────────────╮
│ add    Add mail address         │
│ set                             │
│ list   List mail addresses      │
│ del    Delete mail address      │
╰─────────────────────────────────╯

Mail addresses constitute a mailbox.

List mail addresses¶

List your mail addresses with uberspace mail address list:

[isabell@moondust ~]$ uberspace mail address list

  Name           Domain           sysmail   catchall   alias   Alias of         Forwards
 ───────────────────────────────────────────────────────────────────────────────────────────────────────
  example        isabell.example  no        no         no
  forward        isabell.example  no        no         no                       example@isabell.example
  catchall       isabell.example  no        yes        no

Add a mail address¶

You can setup as many mail addresses as you like. Always use full mail addresses like example@isabell.example. If you want to use your own domain make sure to set it up first.

Sending mail

In order to use a mail address as the sender, it must be configured on the Asteroid.

To add a new mailbox to your Asteroid, run uberspace mail address add <address>.

[isabell@moondust ~]$ uberspace mail address add example@isabell.example
enter password (hidden):
confirm password (hidden):
OK: Added mailaddress 'example@isabell.example' to your Asteroid

Aliases¶

You can setup alias addresses to existing mail addresses. Mail sent to this address will be delivered to the original mailbox. You can't use the alias address to access your mailbox, but you can use it as the sender address.

To add a new alias to an existing mail address, run uberspace mail address add <address> --alias-of <existing_address>.

[isabell@moondust ~]$ uberspace mail address add alias@isabell.example --alias-of example@isabell.example
OK: Added mailaddress 'alias@isabell.example' to your Asteroid

Tip:

You can also add alias domains to make all addresses with one domain work with another domain.

Features¶

Mailboxes/mail addresses have several configurable properties. You can change the properties of an address with uberspace mail address set:

[isabell@moondust ~]$ uberspace mail address set --help

 Usage: uberspace mail address set [OPTIONS] MAILADDRESS

╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
│ *    mailaddress      TEXT  mailaddress [default: None] [required]                     │
╰────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
│ --password                                 TEXT  provide a password non-interactively  │
│                                                  [default: None]                       │
│ --password-ask                                   provide a password interactively      │
│ --sysmail                                        set this as sysmail address           │
│ --catchall           --no-catchall               set this as catchall address          │
│                                                  [default: no-catchall]                │
│ --forward                                  TEXT  add forward to mailaddress            │
│ --no-forward                               TEXT  delete forward from mailaddress       │
│ --keep-forwards      --no-keep-forwards          for forwarded mails, keep a copy of   │
│                                                  the mail in mailbox                   │
│                                                  [default: no-keep-forwards]           │
│ --help           -h                              Show this message and exit.           │
╰────────────────────────────────────────────────────────────────────────────────────────╯

Forwards¶

Keep forwarded mail

You can configure mailboxes with forwards to keep mail: use --keep-forwards and --no-keep-forwards.

To forward mail to another mail address use the --forward flag: uberspace mail address add <address> --forward isabell@otherprovider.example. You can forward mail to multiple addresses: uberspace mail address add <address> --forward isabell@otherprovider.example --forward klaus@otherprovider.example

You can remove a forward with the --no-forward argument: uberspace mail address set <address> --no-forward isabell@otherprovider.example

[isabell@moondust ~]$ uberspace mail address add forwardme@isabell.example --forward isabell@otherprovider.example --forward klaus@otherprovider.example
OK: Added mailaddress 'forwardme@isabell.example' to your Asteroid

Catchall mailbox¶

To configure a catchall mailbox use --catchall and --no-catchall:

[isabell@moondust ~]$ uberspace mail address set example@isabell.example --catchall
OK: Changed config for mailaddress 'example@isabell.example'
[isabell@moondust ~]$ uberspace mail address set example@isabell.example --no-catchall
OK: Changed config for mailaddress 'example@isabell.example'

Set password¶

Set a new password for a mail address with uberspace mail address set <address> --password-ask:

[isabell@moondust ~]$ uberspace mail address set example@isabell.example --password-ask
enter password (hidden):
confirm password (hidden):
OK: Changed password for mailaddress 'example@isabell.example'

non interactive

You can also provide a password non-interactively via cmd with --password PASSWORD. However, this means it shows up in the process list as well as in your shell history file, so we recommend to use --password-ask instead.

Delete mail addresses¶

Warning:

This will not only delete the mailbox and its optional forwards, but also all alias addresses pointing to that mailbox.

Delete a mail address with uberspace mail address del <address>:

[isabell@moondust ~]$ uberspace mail address del forwardme@isabell.example
OK: Removed mailaddress 'forwardme@isabell.example' from your Asteroid

Beware that a mailbox which is defined as your system mail address (carrying the sysmail flag) can't be deleted. If you want to delete that mailbox, you have to declare a different mailbox as your system mail address first.

System mail address¶

With each Asteroid you will get an mail address in the form USERNAME@uber.space. By default this mail address is an alias for sysmail@USERNAME.uber.space which forwards to the external mail address you have given with your registration.

This address will also be used as a system mail address: services like cron will send mail to this address.

Manage the address¶

This address can be set up as an alias for any given mailbox on your Asteroid.

On a new Asteroid this is the default mailbox sysmail@USERNAME.uber.space. You can see it in your mail address list (mind the sysmail column):

[isabell@moondust ~]$ uberspace mail address list

  Name       Domain               sysmail   catchall   alias   Alias of   Forwards
 ─────────────────────────────────────────────────────────────────────────────────────────
  sysmail    isabell.uber.space   yes       no         no                 uberspace@example.com

This default mailbox works like any other mailbox you have added to your Asteroid, you can disable or change forwards, use filters etc. The only difference is, that is has the sysmail option and that way also receives mail for USERNAME@uber.space.

In order to make it accessible with mail clients you need to set a password first.

Change the mailbox¶

If you want to receive mail for USERNAME@uber.space in another custom mailbox, you can use the option --sysmail:

[isabell@moondust ~]$ uberspace mail address add hallo@mydomain.com --sysmail
...
[isabell@moondust ~]$ uberspace mail address list

  Name      Domain                         sysmail   catchall   alias   Alias of   Forwards
 ───────────────────────────────────────────────────────────────────────────────────────────
  hallo     mydomain.com                   yes       no         no
  sysmail   isabell.uber.space             no        no         no

Now the new mail address has the sysmail option.

Only one address at a time can be declared as the system mail address. Setting this flag will remove it from the address having it before.

Tip:

The default sysmail@USERNAME.uber.space mailbox is only a convention. Should you declare a different mailbox as your system mail address, you may delete the default sysmail@USERNAME.uber.space mailbox. Beware that by default this mailbox also carries the postmaster, hostmaster and abuse aliases which will be deleted as well. We suggest to set them up again and have them point to another mail address of your choice.