Quick setup

The CipherMail gateway is typically installed as a store and forward server. There are multiple ways the gateway can be placed within the existing infrastructure. See Network architecture for some examples on how to integrate the CipherMail gateway into your infrastructure.

The quick setup guide assumes that the gateway is already installed, either using the Virtual Appliance or using the provided installation packages, and that the gateway has a valid IP address. See the Gateway installation guide or the Virtual Appliance guide for details on how to install the gateway.

Assuming the gateway is using IP address 192.168.1.2, login to the admin pages by opening the following URL in your browser https://192.168.1.2 (replace with the correct IP address).

Note

If the CipherMail gateway was installed using the rpm or deb packages, i.e., not using the Virtual Appliance, the default URL should be https://192.168.1.2:8443/ciphermail

Use the following default credentials:

username

admin

password

admin

Note

It can take some time to login after a restart because the web application must be initialized upon first login.

Initial setup wizard Pro/Ent only

The first time the gateway is started, a notification is shown asking whether to start the initial setup wizard.

The initial setup wizard will help with setting up a functional gateway.

Initial setup wizard

Note

Additional wizards can be selected from the wizard sub menu (Admin ‣ Other ‣ Wizards)

The initial setup wizard will help setting up the following items:

  1. CipherMail license

  2. Hostname

  3. DNS

  4. Domains

  5. Mail server (MTA)

  6. Notification settings

  7. Portal base URL

  8. Encrypt mode

Finish the wizard and reboot the gateway if required. After running the initial setup wizard, the gateway should be setup for sending and receiving email.

Send test email

Send a test email using the built-in “Compose a test email” tool (Admin ‣ Other ‣ Send email)

  1. Send a test email to an external recipient.

  2. Send a test email to an internal recipient.

Tip

Check the MTA logs (Logs ‣ MTA) to see if the message was succesfully delivered. If not, the MTA logs should provide more information as to why the email could not be delivered.

Without wizard

If you are using the community edition of the CipherMail gateway, which lacks the wizards, use the following procedure to configure the gateway:

  1. Configure hostname

  2. Configure DNS

  3. Configure MTA

  4. Add internal domains

Configure hostname (Admin ‣ Network ‣ Hostname)

Set the hostname to a fully qualified hostname.

Configure DNS (Admin ‣ Network ‣ DNS)

Configure at least one DNS entry.

Configure MTA (Admin ‣ MTA ‣ Config)

Configure “Relay domains”, “My networks”, “Relay hosts” etc.

Add internal domains

For every domain configured as a “Relay domain” execute the following steps:

  1. Add a new domain (Domains ‣ Add domain)

  2. Set “Locality” to “Internal”

  3. Apply settings

Send test email

Send a test email using the built-in “Compose a test email” tool (Admin ‣ Other ‣ Send email)

  1. Send a test email to an external recipient.

  2. Send a test email to an internal recipient.

Tip

Check the MTA logs (Logs ‣ MTA) to see if the message was succesfully delivered. If not, the MTA logs should provide more information as to why the email could not be delivered.