# EmailEngine

Generated on 2 Jul 2025 from [the EmailEngine catalog page](https://marketplace.digitalocean.com/apps/emailengine)

> **NB!** You can not use EmailEngine to send emails from DigitalOcean droplets, as all email ports are blocked by default.

EmailEngine provides seamless email account access via a REST API by maintaining active IMAP connections to each account. It converts API requests into email server commands and continuously monitors for updates, enabling real-time interaction with email accounts.

Ideal for developers and businesses looking to implement robust email integration without delving into intricate IMAP, SMTP, and OAuth2 protocols. With EmailEngine, you get a powerful platform that does more than a basic email library, offering comprehensive features for complex operations like OAuth2 handling, email sending, and receiving notifications.

## Software Included

| Package | Version | License |
|---|---|---|
| [EmailEngine](https://emailengine.app/) | [2.50.9](https://github.com/postalsys/emailengine/releases/tag/v2.50.9) | [Commercial](https://github.com/postalsys/emailengine/blob/master/LICENSE_EMAILENGINE.txt) |

## Creating an App using the Control Panel

Click the **Deploy to DigitalOcean** button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

[![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/droplets/new?image=postalsystemso-emailengine)

## Creating an App using the API

In addition to creating a Droplet from the EmailEngine 1-Click App using the control panel, you can also use the [DigitalOcean API](https://docs.digitalocean.com/reference/api). As an example, to create a 4GB EmailEngine Droplet in the SFO2 region, you can use the following `curl` command. You need to either save your [API access token](https://docs.digitalocean.com/reference/api/create-personal-access-token/index.html.md) to an environment variable or substitute it in the command below.

```shell
curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"postalsystemso-emailengine"}' \
        "https://api.digitalocean.com/v2/droplets"
```

## Getting Started After Deploying EmailEngine

1. Set up an A-record in your DNS, pointing your domain to the droplet’s public IP address.
2. Access the droplet via SSH and provide your domain name and admin password: `ssh root@your_droplet_public_ipv4`.
3. Navigate to `http://your_droplet_public_ipv4` and click *Manage EmailEngine*.
4. Sign in using the username “admin” and the password from step 2.
5. Start your 14-day trial by clicking the *Start a 14-day trial* button.

### Next Steps

1. Add your IMAP account on the Accounts page to start monitoring it.
2. Generate an access token from the Access tokens page.
3. Test API requests using the API Reference page for the monitored account.
4. Keep EmailEngine updated by running: `sudo /opt/upgrade-emailengine.sh`.