🧠Advanced Installation

Installation can occur on any Ubuntu Linux server with an AMD64-compatible or ARM64 CPU.

Check to ensure your server has a swap partition enabled, Digital Ocean droplets do not come with swap preconfigured.

Redis recommends that vm.overcommit_memory = 1 be set in /etc/sysctl.conf. After changing /etc/sysctl.conf, run the command sysctl vm.overcommit_memory=1

To install and setup your platform we're going to need to complete the following steps, which will be outlined in detail below:

Run the curl one-liner emailed to you with your embedded license key to download the installation archive, e.g.:

curl -L https://api.keygen.sh/v1/accounts/5b5014e5-3f60-430e-af80-b0004f2eb853/artifacts/edcom-install.tgz -H 'Authorization: License XXXXXXXXXXX-V3' -o edcom-install.tgz

Extract the archive as the root user in the desired install location:

tar xzvf edcom-install.tgz

Files will be extracted into a single directory named edcom-install where the entirety of the emaildelivery.com platform will reside going forward.

Change to the edcom-install directory:

cd edcom-install

Install Docker Engine

We include an automated Docker installation script for Ubuntu:

./install_docker_on_ubuntu.sh 

See Docker installation instructions for Debian, CentOS, Fedora

Run the following command to load the Docker images:

./load_images.sh

Copy the file config/edcom.defaults.json to config/edcom.json

cp config/edcom.defaults.json config/edcom.json

Open the config/edcom.json file with an editor such as Nano, Vim, or Emacs and edit the following lines:

"admin_url": "http://your_domain_name",
"license_key": "LICENSE KEY THAT YOU USED TO DOWNLOAD THE SOFTWARE",
"smtphost": "your_domain_name"

The admin_url andsmtphostare your platform's management domain, use a subdomain such as esp.mydomain.com.

To start the platform, run the following command:

./restart.sh

Then run the following command to create your administrator account:

./create_admin.sh "[email protected]" "Your Name" "Company Name"

The email address you use here doesn't have to be a real one, it's just your Administrator username.

Set your administrator password and initialization will complete.

Run ./create_admin.sh --help for more information and ./reset_password.sh -h if you lose your administrator password.

Next, enable Let's Encrypt for HTTPS://.

Last updated

Was this helpful?