💽ESP Installation

For best performance, a dedicated Ubuntu VPS with 2 vCPU, 4 GB RAM, and NVMe storage is a good minimum spec.

See the recommended VPS for suggested providers.

Installation must be run as root. sudo is unsupported.

Docker Compose is a prerequisite

This optional next step will uninstall any older Docker versions.

A Docker install script for Ubuntu is included for convenience:

./install_docker_on_ubuntu.sh

Create a subdomain in your DNS provider

Add an A record, such as esp.yourdomain.com where your DNS records are hosted (e.g., Cloudflare), and point it to the IP address of your VPS or server.

You'll need to enter this domain and IP address during installation.

Download the installation archive and run the setup wizard:

Intel/AMD:

curl -LO https://github.com/emaildelivery/edcom-ce/releases/latest/download/edcom-install-amd64.tgz
tar -xzvf edcom-install-amd64.tgz
cd edcom-install
./ez_setup.sh 

ARM/AArch64:

curl -LO https://github.com/emaildelivery/edcom-ce/releases/latest/download/edcom-install-arm64.tgz
tar -xzvf edcom-install-arm64.tgz
cd edcom-install
./ez_setup.sh 

Common installation issues

Problem? See this section in the documentation.

Access your ESP platform

Open your web browser to the domain you configured above (e.g., esp.yourdomain.com) and log in with the admin account you created during setup.

Follow the "Getting Ready to Send" guide to send your first message.

Secure your platform with HTTPS.

Enable embedded Beefree premium HTML email builder

1. Create a file called edcom-install/config/commercial_license.key containing your license key

2. Run ./restart.sh in edcom-install