Getting Started with Xeams on AWS

Once you subscribe/purchase Xeams on AWS, you can now launch an instance, a VM with Xeams already installed on it. Before you can use Xeams to receive emails from the internet, as well as send out emails to the internet, there are a few requirements to fulfill. These include:

  • Domain Name: you will need a domain name. You can purchase one through a domain provider, such as godaddy or Amazon route 53.
  • A and MX record: You will need these records to let senders know where your server is. Please see here on changing MX records in well-known DNS providers.
  • Static IP address: SMTP servers will typically need to have a Static IP address. This is also known as Elastic IP address in AWS. Please see step number 3 below to configure this.
  • PTR Record: Also known as reverse DNS lookup, this record is necessary to send outbound emails. PTR records must be added by whoever owns your IP address. This is typically done through your ISP. In AWS, please see here on adding a PTR record.
To launch the instance, follow the instructions below.

1. Launching an instance from Xeams AMI

To start, access your EC2 dashboard. Click on Launch Instance as shown below:

AWS Launch Instance

You can also click on Instances on the left menu, then click on Launch instance.

You will now see a launch instance wizard. Here, you will need to specify multiple options:

  • Name: specify any name here.
  • AMI: select the Xeams AMI.
  • Instance Type: Select the instance type for Xeams. We recommend selecting t2.medium.
  • Keypair: Keypair is used to access the machine (SSH) where Xeams is running. Specify a key pair that you use here (if not, create a key pair). See here for more information about key pairs.
  • Network settings: By default, ports 22, 80, 443, and 5272 should be open. In not, configure these ports to be available.
  • Configure storage: By default, 30 GB is set. Increase this value higher if you need additional disk space.

Once configured, you will see a summary at the bottom. Confirm the settings are correct, then click on Launch instance. You will see your instance on the instances page as shown below:

AWS Instance Running

2. Accessing Xeams Interface from the Instance

Once the instance is running, you can now access the web interface of Xeams. You can access it by entering the public IP address in your address bar, or by entering the hostname. If you click the checkbox next to the instance on the instance page, this will bring up the instance detail. In the detail tab, you can also click on "open address" next to the address/hostname: AWS Open Instance You should now see the initial setup for Xeams. Follow the instructions on the interface to complete your setup.

3. Configure Static IP address

Static IP address: You can configure the instance IP as a static IP address (also called an elastic IP on AWS). To configure this, please see here for instructions.

4. Other Questions

How do I modify Instance settings (Storage, firewall rules, etc.)

You can modify other instance settings by highlighting your instance, then go to either the security tab (for firewall rules) or the storage tab (to increase the disk size). For detailed instructions, please see here for changing the disk size, and here for changing firewall rules, and here for changing instance type.