Product docs and API reference are now on Akamai TechDocs.
Search product docs.
Search for “” in product docs.
Search API reference.
Search for “” in API reference.
Search Results
 results matching 
 results
No Results
Filters
Postfix, Dovecot, and System User Accounts on Ubuntu 10.10 (Maverick)
- Deprecated guides:
- Ubuntu 10.04
- Debian 6
- Debian 5
Traducciones al EspañolEstamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.
DeprecatedThis guide has been deprecated and is no longer being maintained.
Postfix is a popular mail transfer agent or “MTA”. This document will allow you to create a mail system using Postfix as the core component and aims to provide a simple email solution that uses system user accounts for authentication and mail delivery and Dovecot for remote mailbox access. If you do not need to authenticate to Postfix for SMTP service or use POP or IMAP to download email, you may consider using the basic email gateway with Postfix document to install a more minimal email system. If you plan to host a larger number of domains and email aliases, you may want to consider a more sophisticated hosting solution like the email server with Postfix, MySQL and Dovecot.
Set the Hostname
Before you begin installing and configuring the components described in this guide, please make sure you’ve followed our instructions for setting your hostname. Issue the following commands to make sure it is set properly:
hostname
hostname -f
The first command should show your short hostname, and the second should show your fully qualified domain name (FQDN).
Install Software
Issue the following commands to install any outstanding package updates:
apt-get update
apt-get upgrade
Issue the following command to install all required software:
apt-get install libsasl2-2 libsasl2-modules sasl2-bin postfix dovecot-postfix
During the installation process, the package manager will prompt you for the responses to a few questions to complete the Postfix installation. To the first question regarding the type of mail server you want to configure, select “Internet Site” and continue as in the following image:
![](/docs/images/pix.gif)
![Selecting the Postfix mail server configuration type on a Ubuntu 10.10 (Maverick) system. Selecting the Postfix mail server configuration type on a Ubuntu 10.10 (Maverick) system.](/docs/guides/postfix-dovecot-and-system-user-accounts-on-ubuntu-10-10-maverick/91-postfix-courier-mysql-02-mail-server-type-2_hucabb7728fb4830116ddbca9c12fab29b_9409_694x0_resize_q71_bgfafafc_catmullrom_3.jpg)
![Selecting the Postfix mail server configuration type on a Ubuntu 10.10 (Maverick) system. Selecting the Postfix mail server configuration type on a Ubuntu 10.10 (Maverick) system.](/docs/guides/postfix-dovecot-and-system-user-accounts-on-ubuntu-10-10-maverick/91-postfix-courier-mysql-02-mail-server-type-2_hucabb7728fb4830116ddbca9c12fab29b_9409_1388x0_resize_q71_bgfafafc_catmullrom_3.jpg)
The next prompt will ask for the system mail name. This should correspond to the fully qualified domain name (FQDN) that points to your Linode’s IP address. In this example, we’re using a machine specific hostname for our server. Set the reverse DNS for your Linode’s IP address to the fully qualified domain name you assign as the system mail name. You will be able to send mail from additional domains as configured later in this document. See the following example:
![](/docs/images/pix.gif)
![Selecting the Postfix system mail name on a Ubuntu 10.10 (Maverick) system. Selecting the Postfix system mail name on a Ubuntu 10.10 (Maverick) system.](/docs/guides/postfix-dovecot-and-system-user-accounts-on-ubuntu-10-10-maverick/92-postfix-courier-mysql-02-mail-server-type-3_hu9b4b2206afa5f4291359929ff0b411bc_17128_694x0_resize_q71_bgfafafc_catmullrom_3.jpg)
![Selecting the Postfix system mail name on a Ubuntu 10.10 (Maverick) system. Selecting the Postfix system mail name on a Ubuntu 10.10 (Maverick) system.](/docs/guides/postfix-dovecot-and-system-user-accounts-on-ubuntu-10-10-maverick/92-postfix-courier-mysql-02-mail-server-type-3_hu9b4b2206afa5f4291359929ff0b411bc_17128_1388x0_resize_q71_bgfafafc_catmullrom_3.jpg)
SASL Authentication
Edit the /etc/default/saslauthd
file to allow the SASL authentication daemon to start. Uncomment or add the following line:
- File: /etc/default/saslauthd
1
START=yes
Create the /etc/postfix/sasl/smtpd.conf
file, and insert the following line:
- File: /etc/postfix/sasl/smtpd.conf
1 2 3 4
smtpd_tls_cert_file=/etc/ssl/postfix.pem smtpd_tls_key_file=/etc/ssl/postfix.key smtpd_sasl_application_name = smtpd
These settings make it possible for the SASL authentication process to interact with Postfix, and for Postfix to use the SSL certificate generated above. If you’re using an SSL certificate with a different name, modify the first two lines of this configuration section.
When all modifications to the Postfix configuration are complete, issue the following command to restart Postfix to allow these configuration changes to take effect.
/etc/init.d/postfix restart
At this point you should be able to send email using your Postfix instance by authenticating with SMTP. Authentication credentials are your system user accounts.
Consider the basic email gateway guide for more information regarding Postfix virtual hosting configuration. If you need to deliver mail locally, continue for documentation of mail routing and the Dovecot POP3/IMAP server.
Configure Mail Delivery
The above Postfix configuration makes it possible to send mail using Postfix. If your server receives email, Postfix requires additional configuration to deliver mail locally. Edit the main.cf
file to insert or modify the following configuration directives:
- File: /etc/postfix/main.cf
1 2 3
myhostname = lollipop.example.com virtual_alias_maps = hash:/etc/postfix/virtual home_mailbox = mail/
Issue the following command to ensure that new user accounts have a ~/mail
directory:
mkdir /etc/skel/mail/
Every existing user that receives email will also need to make their own Maildir
, by issuing the following command:
mkdir ~/mail/
Create a /etc/postfix/virtual
file to map incoming email addresses to their destinations. Consider the following example:
- File: /etc/postfix/virtual
1
protocols = imap imaps pop3 pop3s mangesieve
The protocols
directive enables imap
and pop3
services within Dovecot along with their SSL-encrypted alternatives. You may remove any of these services if you do not want Dovecot to provide imap
, pop3
, or SSL services.
Edit and modify the following lines in the /etc/dovecot/conf.d/01-dovecot-postfix.conf
file to configure Dovecot to use the SSL certificates you generated earlier:
- File: /etc/dovecot/conf.d/01-dovecot-postfix.conf
1 2
ssl_cert_file = /etc/ssl/postfix.pem ssl_key_file = /etc/ssl/postfix.key
You may replace the files specified with another .pem
and .key
file generated for another service, if needed. Modify the mail_location
directive as follows so that Dovecot can interact properly with your Maildirs:
- File: dovecot.conf
1
mail_location = maildir:~/mail:LAYOUT=fs
Once configured, issue the following command to restart the Dovecot instance:
restart dovecot
You may now access email by configuring a local email client to contact the server you have set up. Authentication credentials are the same as the system user accounts. These accounts can be configured outside of this document at any time.
Organize Mail Services
This document describes a complete email system configuration. How you use and manage your system from this point forward is beyond the scope of this document. At the same time, we do encourage you to give some thought to the organization of your user accounts and email delivery. Keeping a well organized and easy to manage system is crucial for sustainable use of this system.
Organizational structure is crucial in this kind of deployment because delivery of inbound email addresses are configured independently of user accounts. Furthermore, email accounts and user accounts need not correspond or reference each other. This may be confusing for some users. To help resolve this confusion you may want to establish a systematic convention for email addresses and corresponding user accounts to the mail server.
Remember that system user accounts may provide access to other services on the system. Unless this access is specifically prohibited, all system user accounts will have SSH access to the server using the same credentials that are used for logging into the email services.
More Information
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
This page was originally published on