Email Sync Engine
npm install emailengine-appA headless email client application that provides access to IMAP, SMTP, Gmail API, and MS Graph API resources via a unified REST API. Easily integrate email accounts with your service!
- Full documentation: EmailEngine.app
> [!WARNING]
> EmailEngine is not free open-source software. It is "source available" software, meaning you can view and copy the source code, but you need a paid subscription to run it beyond the free 14-day trial. Each EmailEngine instance comes with this trial, so you can test EmailEngine without any commitment.
- Sync users' emails with your service and send emails on their behalf.
- Integrate your app with a dedicated email account, such as your support email.
- Monitor INBOX and Junk folders of a test email account to track where sent emails land.
- Ideal for lightweight webmail and mobile email apps that prefer to avoid direct IMAP and MIME processing.
!Screenshot 1
!Screenshot 2
!Screenshot 3
Run the following command to check the version and license information for both EmailEngine and its included modules:
``bash`
$ emailengine license
- Redis - Any version
> [!NOTE]
> While Redis does not officially support Windows, alternatives like Memurai are available.
> [!TIP]
> Minimize the latency between EmailEngine and Redis by running both on the same machine or in the same data center. Since EmailEngine runs a separate Redis command for each message in a folder during syncing, high latency can lead to slow sync times for folders with many messages.
- API Reference
- Blog Posts
- OpenAPI specification for Postman: Swagger.json
Refer to the configuration documentation for details on setting up EmailEngine.
By default, EmailEngine only allows connections from localhost. To enable external access, either edit the config file or use the CLI option --api.host="0.0.0.0". Ensure to secure external access with a firewall or proxy to allow only trusted sources.
You can use the included install script to set up:
- EmailEngine as a SystemD service
- Caddy as a reverse proxy and HTTPS certificate handler
`bash`
$ wget https://raw.githubusercontent.com/postalsys/emailengine/master/install.sh
$ chmod +x install.sh
$ ./install.sh example.com
Where example.com is the domain name for EmailEngine.
> [!NOTE]
> Tested on Ubuntu 20.04 and Debian 11. Other versions may not be supported.
Learn more about running EmailEngine as a SystemD service here.
To execute EmailEngine-CLI commands within a Docker container:
1. Exec into the container:
`bash`
$ docker exec -it
2. Run commands using ./bin/emailengine.js:
`bash`
$ node bin/emailengine.js
For full Docker usage documentation, visit here.
EmailEngine relies on Redis as its data store. Redis stores everything in RAM, so if an issue arises, EmailEngine may flood Redis, rendering the app unusable if space runs out.
To diagnose problems:
1. Check Bull Queues: Use the built-in Bull Arena UI to monitor queue states at http://127.0.0.1:3000/admin/bull-board.
2. Scan Keyspace: Run the following to group Redis keys by type and generate a report:
`bash`
$ emailengine scan > keyspace.csv
EmailEngine provides Prometheus metrics, available at the /metrics URL path.
For information on logging options, read the documentation here.
To trace IMAP traffic for a specific account, use the following command:
`bash``
$ npm run raw -- --filter.account=account1
For detailed security and data compliance information, refer to this guide.
EmailEngine is licensed under the commercial EmailEngine License.