Mailu#

Mailu is a simple yet full-featured mail server as a set of Docker images.

amd64
arm64
armv7

Information#

Docker Image: !!! LINK TO DOCKER IMAGE/ DOCKER HUB !!!
Current Image Version: 1.7

SETUP#

Enabling mailu#

Command:#

vlab set mailu.enable True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

mailu
enable: True

Finalising changes:#

run: vlab update_one service=mailu

FIRST RUN#

!!! DEVELOPERS: make sure that you include any information that the user requires to get started, below. !!!
!!! Below are some examples with headings, and with some example instructions !!!

ADMINISTRATOR SETUP#

Navigate to https://False/admin

Create an account with your desired username; as this is the first user, mailu makes this account the administrator.

SMTP/ MAIL#

  1. run vlab decrypt to decrypt the vault.yml file
  2. make some changes

SMTP Settings#

smtp:
host:
port:
user:
pass:
from_email:
from_name:
  1. run vlab update_one service=mailu to complete the changes

Creating Users#

You can create users in the admin interface, by clicking Mail Domains on the main menu, then the envelope icon next to your mail domain.

Users can then also login to the admin interface, but will only be able to adjunt their password and spam settings.

Access#

It is available at https://mailu.vivumlab.xyz/ or http://mailu.vivumlab.xyz/

Admin Access#

It is available at https://admin.mailu.vivumlab.xyz/ui/ or http://admin.mailu.vivumlab.xyz/ui/

You can login using [email protected] and the password found on your server in ~/vivumlab/mailu/.env under INITIAL_ADMIN_PW, or in settings/passwords/mailu_admin_password from your deploy location.

OPTIONS#

HTTPS_ONLY#

Default: False
Options: True/False

Command:#

vlab set mailu.https_only True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

mailu
https_only: True
Finalising changes:#

run: vlab update_one service=mailu

AUTH#

Default: False
Options: True/False

Command:#

vlab set mailu.auth True

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

mailu
auth: True
Finalising changes:#

run: vlab update_one service=mailu

DOMAIN#

Default: False
NOTE: include the sitename and top level domain suffix. eg. name.com, site.net

Command:#

vlab set mailu.domain mailu.com

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

mailu
domain: mailu.com
Finalising changes:#

run: vlab update_one service=mailu

SUBDOMAIN#

Default: mailu
NOTE: Periods/ delimiters are not required. eg. 'media' will set the full URL as 'media.vivumlab.xyz'

Command:#

vlab set mailu.subdomain media

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

mailu
subdomain: media
Finalising changes:#

run: vlab update_one service=mailu

VERSION#

Default: 1.7
NOTE: Ensure that the version exists

Command:#

vlab set mailu.version 2.7

File alteration:#

set the appropriate service settings in settings/config.yml to true

eg.

mailu
version: 2.7
Finalising changes:#

run: vlab update_one service=mailu

Need more help?#

Further information regarding services can be found.
General Information can be found in the documentation.
Additional assistance can be found on our Contact Us page.