# mailto.conf

The /etc/cups/mailto.conf file contains several directives that defines the local mail server and email notification preferences for CUPS. Each directive is listed on a line by itself followed by its value. Comments are introduced using the number sign ("#") character at the beginning of a line.

## Cc

### Examples

    Cc bigbrother@example.com
    Cc John Doe <jd@example.com>

### Description

The `Cc` directive specifies an additional recipient ("carbon copy") for all email notifications. The default is to not send a copy to anyone but the subscriber.

## From

### Examples

    From printserver@example.com
    From Your Happy Printer <printserver@example.com>

### Description

The `From` directive specifies the sender of email notifications. The default is the `ServerAdmin` address defined in the cupsd.conf file.

## Sendmail

### Examples

    Sendmail /usr/sbin/sendmail
    Sendmail /usr/lib/sendmail -bm -i

### Description

The `Sendmail` directive specifies the command to run to deliver an email locally. This directive cannot be used with the `SMTPServer` directive, and if both `Sendmail` and `SMTPServer` lines appear in the mailto.conf file, only the last line is used. The default is `/usr/sbin/sendmail`.

## SMTPServer

### Examples

    SMTPServer mail.example.com
    SMTPServer 192.168.2.1

### Description

The `SMTPServer` directive specifies a hostname or IP address of a (possibly remote) SMTP mail server. This directive cannot be used with the `Sendmail` directive, and if both `Sendmail` and `SMTPServer` lines appear in the mailto.conf file, only the last line is used. The default is to use the `Sendmail` command instead.

## Subject

### Examples

    Subject [CUPS]
    Subject URGENT EMAIL NOTIFICATION

### Description

The `Subject` directive specifies a prefix string to add to the subject of each email notification. The default is to not add a prefix string.