dev-ops/mailu-setup.md

setup docker

Add Docker's official GPG key and then add repository to Apt sources

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update -y

to install latest version run:

sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

install Mailu

Mailu will store all of its persistent data in a path of your choice (/mailu by default) simply create the directory and move there:

mkdir /mailu
cd /mailu

check IP need in next step

ifconfig eth0

then use this util

follow instructions to docker compose.

once done, you need to manually create the admin account now:

docker compose exec admin flask mailu admin me example.net 'password'

This will create a user named me@example.net with password password and administration privileges. Connect to the Web admin interface and change the password to a strong one.

Upgrading the mail server

First check upstream for changes in the docker-compose.yml or in the .env files. Also, check CHANGELOG.md for changes that you might not want to include.

Update your .env file to reflect the version that you wish to install (if you are running stable or latest, you may skip this and proceed), then simply pull the latest images and recreate the containers :

docker compose pull
docker compose down
docker compose -p mailu up -d