Connecting your own mail backend

From Hostcontrol Wiki
Jump to: navigation, search


OX is a webmail client that connects to a mail backend. Technically, we refer to this as a front-end. A front-end may connect to any back-end that suppors the connection.

Since the connection is simply IMAP, and since migrating email is undesirable, Open Exchange was partially designed for serving as a front-end for any email system - including the ones already in place. See the below diagram for an easy, visual explanation.
OX flow.png
This advanced article deals with setting up OX to deal with your backend, rather than the Hostcontrol backend.

Server structure & user management requirements

In order for the IMAP login to proceed as intended, the IMAP username structure needs to be identical. Your IMAP username on your own backend should always be the **complete e-mail address**, either as primary login name or alias (if supported).

Apart from that, your server should **allow incoming connection on one port, and outgoing ones on another**. Ports 143/110 and 25 for incoming/outdoing are not enforced. Additionally, SSL is automatically detected.

Lastly, users and mailbox should be created separately on your mail backend before adding them as an email user. This ensures the IMAP connection can take place.

Setting up accounts

Open Exchange works by means of mailbox users. A user uses a license, and a license is connected to a plan. Our configuration is plan-based; you connect the plan to your mail backend, after which any license attached to that plan automatically uses the same settings.

In order to connect your plan, take the following steps:


Ox ca settings1.png

  • Next, open the plan you wish:


Ox ca settings2.png

  • Go to the settings tab:


Ox ca settings3.png

  • Fill in the values of your server (an IP address is required, as well as a port number).
  • Save. After saving, this plan will now send login attempts to your own server.