Replacing SSMTP with MSMTP in Docker
Tags: docker, php, msmtp
Published: 2020-02-19 15:52:39

---
title: Replacing SSMTP with MSMTP in Docker
published: true
date: 2019-08-26 00:00:00 UTC
tags: docker,php,msmtp
canonical_url: https://owendavies.net/articles/setting-up-msmtp/
---

Trying to build a new image of a Docker file that I’ve been running for months, and I’m greeted with this error:

```
Package ssmtp is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source

E: Package 'ssmtp' has no installation candidate

```

Looks like [sSMTP](https://wiki.debian.org/sSMTP) is no longer maintained, and has been orphaned since 19th March 2019. [MSMTP](https://wiki.debian.org/msmtp) is the suggested replacement. So let’s get replacing.

<!--more-->
# The plan

1. Install mSMTP in our Docker image
2. Configure mSMTP to our smtp server (in this case Office 365)
3. Tell PHP to use mSMTP for email instead of sSMTP
4. Send a test email
5. Final source

## 1. Install mSMTP in our Docker image

We’re going to start with the _php:7.30-apache_ docker image

```
FROM php:7.3-apache

```

Lets install msmtp with apt-get, and tidy up afterwards:

```
apt-get update && apt-get install ssmtp -y && \
rm -rf /var/lib/apt/lists/*

```

## 2. Configure mSMTP to our smtp server (in this case Office 365)

We need to setup a configuration file for msmtp to have the smtp details. The msmtp config location is in /etc/

Let’s create a new file called msmtprc, and add the following configuration:

```
account default
host smtp.office365.com
port 587
tls on
tls_starttls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
tls_certcheck on
auth on
user user@domain.com
password "YourAwesomeStr0ngP4zzw0rd"
from "user@domain.com"
logfile /var/log/msmtp.log

```

This is for Office 365, change the smtp details to gmail or your own smtp server.

### Copy the config into our Docker image

```
COPY msmtprc /etc/msmtprc

```

### Make the msmtprc config file readable/writable by its owner

```
RUN chmod 600 /etc/msmtprc

```

## 3. Tell PHP to use mSMTP for email instead of sSMTP

Now that we have mSMTP setup, we need to tell PHP to use it.

### You can get a copy of the default php.ini file from the docker image we have just created. It’s located in _/usr/local/etc/php/php.ini-production_

```
docker cp <CONTAINER_ID>:/usr/local/etc/php/php.ini.production .

```

### Open up your php.ini file, and make the following change to the sendmail\_path variable:

```
sendmail_path = /usr/bin/msmtp -t

```

### Copy your php.ini file to the Docker image php config location:

```
COPY php.ini $PHP_INI_DIR/php.ini

```

## 4. Send a test email

With all that setup we should now be able to send an email.

### 1. Build the Docker image

```
docker build . -t php-msmtp-setup:latest

```

### 2. Run the container

```
docker run -d -p 80:80/tcp php-msmtp-setup:latest

```

### 3. Log into the container

#### Run the following command to find the CONTAINER ID of our new container

```
docker container ls

```

#### Run the following command to login to the container

```
docker exec -ti <CONTAINER_ID> /bin/bash

```

### 4. Send an email directly with msmtp

```
echo -e "Subject: Test Mail\r\n\r\nThis is a test mail, let me know if this works" |msmtp --debug --from from@yourdomain.com -t to@someone.com

```

### 5. Send an email with php

```
php -r "mail('to@domain.com','Test Mail from PHP', 'This is a test mail from PHP, let me know if this works');"

```

## 5. Final source

### Our _Docker_ file

```
FROM php:7.3-apache

RUN apt-get update && apt-get install msmtp -y && \
    rm -rf /var/lib/apt/lists/*

COPY msmtprc /etc/msmtprc
RUN chmod 600 /etc/msmtprc

COPY php.ini $PHP_INI_DIR/php.ini

EXPOSE 80

```

### The changes to our _php.ini_ file

```
sendmail_path = /usr/bin/msmtp -t

```

### Our _msmtprc_ file

```
account default
host smtp.office365.com
port 587
tls on
tls_starttls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
tls_certcheck on
auth on
user user@domain.com
password "YourAwesomeStr0ngP4zzw0rd"
from "user@domain.com"
logfile /var/log/msmtp.log

```