kumomta/docs/tutorial/install_with_docker.md

Installing KumoMTA in a Docker container

To build a lightweight alpine-based docker image:

• Prepare your system with the needed essentials (see System Preparation)
• Ensure docker is actually installed in your server instance.

APT based systems

In Ubuntu, Debian, and other Debial APT package management systems:

sudo apt update
sudo apt install -y apt-utils docker.io
sudo snap install docker

DNF based systems

In Rocky, Alma, and any other DNF package manager system

 sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo
 sudo dnf update -y
 sudo dnf install -y docker-ce docker-ce-cli containerd.io
 sudo systemctl enable docker

If you get an error that /etc/rc.d/rc.local is not marked executable then make it executable with sudo chmod +x /etc/rc.d/rc.local

Start Docker

sudo systemctl start docker

Check if Docker is running

systemctl status docker

Enable Non-Root User Access

After completing Step 3, you can use Docker by prepending each command with sudo. To eliminate the need for administrative access authorization, set up a non-root user access by following the steps below.

1. Use the usermod command to add the user to the docker system group. sudo usermod -aG docker $USER

2. Confirm the user is a member of the docker group by typing: id $USER

It is a good idea to restart to make sure it is all set correctly (init 6)

Build the docker image

At the time of this writing, the Docker image needs to be built from the project repo. You will need to clone the repo and then build the image from ./docker.

sudo dnf install -y git
git clone https://github.com/kumomta/kumomta.git

cd kumomta/docker/redis/
sudo docker build -t redis-cell .
docker run --name redis -p 6379:6379 -d redis-cell
cd ../..
sudo ./docker/kumod/build-docker-image.sh

This should result in something roughly like this:

docker image ls kumomta/kumod
REPOSITORY      TAG       IMAGE ID       CREATED         SIZE
kumomta/kumod   latest    bbced15ff4d1   3 minutes ago   116MB

You can then run that image; this invocation mounts the kumo src dir at /config and then the KUMO_POLICY environment variable is used to override the default /config/policy.lua path to use the SMTP sink policy script sink.lua, which will accept and discard all mail:

$ sudo docker run --rm -p 2025:25 \
    -v .:/config \
    --name kumo-sink \
    --env KUMO_POLICY="/config/sink.lua" \
    kumomta/kumod