Introduction

Exim4 is a Message Transfer Agent (MTA) developed at the University of Cambridge for use on Unix systems connected to the internet. Exim can be installed in place of sendmail or Postfix, although the configuration of exim is quite different to that of sendmail.

Installation

Install the exim4 package from the Main repository using your favorite package manager (see InstallingSoftware).

Configuration

To configure exim4, run the following command:

sudo dpkg-reconfigure exim4-config

The user interface will be displayed. The user interface lets you configure many parameters. For example, In exim4 the configuration files are split among multiple files. If you wish to have them in one file you can configure accordingly in this user interface.

All the parameters you configure in the user interface are stored in /etc/exim4/update-exim4.conf.conf file. If you wish to re-configure the program, either re-run the configuration wizard or manually edit this file using your favourite editor. Run the following command to generate the master configuration file:

sudo update-exim4.conf

The master configuration file will be generated and stored in /var/lib/exim4/config.autogenerated.

IconsPage/warning.png Note: Never directly edit the master configuration file, /var/lib/exim4/config.autogenerated. It is updated automatically every time you run update-exim4.conf

The following command will start the exim4 daemon:

sudo /etc/init.d/exim4 start

TODO: This section should cover configuring SMTP AUTH with exim4.

SMTP Authentication

In this section we'll configure Exim4 to use SMTP AUTH using TLS and SASL. The instructions below assume a split Exim4 configuration is used.

The first step is to create a certificate for use with TLS. Enter the following into a terminal prompt:

sudo /usr/share/doc/exim4-base/examples/exim-gencert

Now Exim4 needs to be configured for TLS by editing /etc/exim4/conf.d/main/03_exim4-config_tlsoptions add the following:

MAIN_TLS_ENABLE = yes

Next you need to configure Exim4 to use the saslauthd for authentication. Edit /etc/exim4/conf.d/auth/30_exim4-config_examples and uncomment the plain_saslauthd_server and login_saslauthd_server sections:

 plain_saslauthd_server:
   driver = plaintext
   public_name = PLAIN
   server_condition = ${if saslauthd{{$auth2}{$auth3}}{1}{0}}
   server_set_id = $auth2
   server_prompts = :
   .ifndef AUTH_SERVER_ALLOW_NOTLS_PASSWORDS
   server_advertise_condition = ${if eq{$tls_cipher}{}{}{*}}
   .endif
#
 login_saslauthd_server:
   driver = plaintext
   public_name = LOGIN
   server_prompts = "Username:: : Password::"
   # don't send system passwords over unencrypted connections
   server_condition = ${if saslauthd{{$auth1}{$auth2}}{1}{0}}
   server_set_id = $auth1
   .ifndef AUTH_SERVER_ALLOW_NOTLS_PASSWORDS
   server_advertise_condition = ${if eq{$tls_cipher}{}{}{*}}
   .endif

Finally, update the Exim4 configuration and restart the service:

sudo update-exim4.conf
sudo /etc/init.d/exim4 restart

Configuring SASL

This section provides details on configuring the saslauthd to provide authentication for Exim4.

The first step is to install the sasl2-bin package from the Main repository (see InstallingSoftware).

To configure saslauthd edit the /etc/default/saslauthd configuration file and set START=no to:

START=yes

Next the Debian-exim user needs to be part of the sasl group in order for Exim4 to use the saslauthd service:

sudo adduser Debian-exim sasl

Now start the saslauthd service:

sudo /etc/init.d/saslauthd start

Exim4 is now configured with SMTP AUTH using TLS and SASL authentication.

Note: this guide has been tested on Ubuntu 7.10 (Gutsy Gibbon)

CategoryInternet CategoryEmail

-  ⇤ ← Revision 1 as of 2007-11-02 19:10:48 → 
  Size: 2770
  Editor: cOn75
  Comment: Created copied content from docbook docs will update soon.
+   ← Revision 10 as of 2011-04-08 15:17:17 → ⇥
  Size: 4250
  Editor: D9784B24
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''Contents'''[[BR]][[TableOfContents(2)]]||
+||<tablestyle="float:right; font-size:0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||
 Line 4:
-Exim4 is another Message Transfer Agent (MTA) developed at the University of Cambridge for use on Unix systems connected to the internet. Exim can be installed in  place of sendmail or Postfix, although the configuration of exim is quite different to that of sendmail.
+Exim4 is a Message Transfer Agent (MTA) developed at the University of Cambridge for use on Unix systems connected to the internet. Exim can be installed in  place of sendmail or Postfix, although the configuration of exim is quite different to that of sendmail.
-Line 8:
+Line 7:
-Line 12:
+Line 10:
-Line 20:
+Line 17:
-All the parameters you configure in the user interface are stored in {{{/etc/exim4/update-exim4.conf}}}.conf file. If you wish to re-configure, either you re-run the             configuration wizard or manually edit this file using your favourite editor. Once you configure, you can run the following command to generate the master  configuration file:
+All the parameters you configure in the user interface are stored in {{{/etc/exim4/update-exim4.conf.conf}}} file. If you wish to re-configure the program, either re-run the             configuration wizard or manually edit this file using your favourite editor. Run the following command to generate the master  configuration file:
-Line 26:
+Line 23:
-The master configuration file, is generated and it is stored in {{{/var/lib/exim4/config.autogenerated}}}.
+The master configuration file will be  generated and stored in {{{/var/lib/exim4/config.autogenerated}}}.
-Line 28:
+Line 25:
-'''Note:''' at any time, you should not edit the master configuration file, {{{/var/lib/exim4/config.autogenerated}}} manually. It is updated automatically every time you run update-exim4.conf
+<<BR>>
{{attachment:IconsPage/warning.png}}
'''Note:''' Never directly edit the master configuration file, {{{/var/lib/exim4/config.autogenerated}}}. It is updated automatically every time you run update-exim4.conf
-Line 30:
+Line 29:
-You can run the following command to start exim4 daemon:
+<<BR>>
The following command will start the exim4 daemon:
 Line 38:
+== SMTP Authentication ==
In this section we'll configure Exim4 to use SMTP AUTH using TLS and SASL.  The instructions below assume a split Exim4 configuration is used.
-Line 39:
+Line 41:
-== From Mailman Page ==
+The first step is to create a certificate for use with TLS.  Enter the following into a terminal prompt:
{{{
sudo /usr/share/doc/exim4-base/examples/exim-gencert
}}}
-Line 41:
+Line 46:
-Once {{{exim4}}} is installed, the configuration files are stored in {{{/etc/exim4/}}}. In ubuntu, by default, the {{{exim4}}} configuration files are split accross different files. You could have changed this behaviour by changing the following variable in the file {{{/etc/exim4/update-exim4.conf.conf}}}:
+Now Exim4 needs to be configured for TLS by editing {{{/etc/exim4/conf.d/main/03_exim4-config_tlsoptions}}} add the following:
-Line 43:
+Line 49:
-dc_use_split_config='true'
}}} which is read by the command {{{/usr/sbin/update-exim4.conf}}}.  Please verify the setting.
+MAIN_TLS_ENABLE = yes
}}}
-Line 46:
+Line 52:
-We can discuss more about exim4 configuration in next section.
For the example configuration described there it is assumed, that {{{dc_use_split_config}}} is  still '''true'''!
+Next you need to configure Exim4 to use the '''saslauthd''' for authentication.  Edit {{{/etc/exim4/conf.d/auth/30_exim4-config_examples}}} and uncomment the '''plain_saslauthd_server''' and '''login_saslauthd_server''' sections:
-Line 49:
+Line 54:
-If you face any problem during installation and if you are unable to solve it, please ask on the appropriate [http://lists.ubuntu.com/mailman/listinfo/ubuntu-users mailing list] for further assistance.
+{{{
 plain_saslauthd_server:
   driver = plaintext
   public_name = PLAIN
   server_condition = ${if saslauthd{{$auth2}{$auth3}}{1}{0}}
   server_set_id = $auth2
   server_prompts = :
   .ifndef AUTH_SERVER_ALLOW_NOTLS_PASSWORDS
   server_advertise_condition = ${if eq{$tls_cipher}{}{}{*}}
   .endif
#
 login_saslauthd_server:
   driver = plaintext
   public_name = LOGIN
   server_prompts = "Username:: : Password::"
   # don't send system passwords over unencrypted connections
   server_condition = ${if saslauthd{{$auth1}{$auth2}}{1}{0}}
   server_set_id = $auth1
   .ifndef AUTH_SERVER_ALLOW_NOTLS_PASSWORDS
   server_advertise_condition = ${if eq{$tls_cipher}{}{}{*}}
   .endif

}}}

Finally, update the Exim4 configuration and restart the service: 

{{{
sudo update-exim4.conf
sudo /etc/init.d/exim4 restart
}}}

== Configuring SASL ==
This section provides details on configuring the '''saslauthd''' to provide authentication for Exim4.

The first step is to install the '''sasl2-bin''' package from the Main repository (see InstallingSoftware).

To configure saslauthd edit the {{{/etc/default/saslauthd}}} configuration file and set ''START=no'' to:
{{{
START=yes
}}}

Next the '''Debian-exim''' user needs to be part of the '''sasl''' group in order for Exim4 to use the saslauthd service:
{{{
sudo adduser Debian-exim sasl
}}}

Now start the '''saslauthd''' service:

{{{
sudo /etc/init.d/saslauthd start
}}}
-Line 52:
+Line 107:
+Exim4 is now configured with SMTP AUTH using TLS and SASL authentication.

<<BR>>
'''Note:''' this guide has been tested on Ubuntu 7.10 (Gutsy Gibbon)
-Line 53:
+Line 113:
-CategoryDocumentation CategoryCleanup
+CategoryInternet CategoryEmail

Ubuntu Documentation

Diff for "Exim4"

Introduction

Installation

Configuration

SMTP Authentication

Configuring SASL