How to Replace PHP GeoIP with MaxMindDB

Depending on the site or application, looking up geographic information related to an IP address can be a pretty common action. When doing IP geolocation in PHP usually the PHP GeoIP extension would be used to facilitate the retrieval of this information. Unfortunately, this particular plugin is no longer actively supported and has not been updated in a number of years.

With the go-to PHP extension of IP geolocation effectively being deprecated, new projects should begin to use the replacement options that are now provided by MaxMind. However, unlike the original GeoIP, which was shipped as a native PHP extension, the new solutions are provided as PHP-based library packages.

Pre-Flight Check

  • Basic familiarity with PHP coding is necessary to utilize Composer packages.
  • Command line access via SSH may be necessary to follow this tutorial.
  • Composer, Curl, funzip must be available on the server.

Step #1: What are my options now?

As mentioned previously, the new options are no longer provided as native PHP extensions, but rather they come as Composer-based PHP packages. The new options provided by MaxMind are either: GeoIP2-php or DB-Reader-php.

Both of the options provide the ability of IP geolocation with subtle differences; in a sense the GeoIP2-php package is an addition built on top of the DB-Reader-php package, it offers all the same features as DB-Reader-php with the addition of API access.

Additionally, it is important to note that only the DB-Reader option is provided without any additional costs. With the new options MaxMind now charges a subscription fee in order to access their APIs.

Generally for most use-cases the necessary features will be provided by the DB-Reader-php package, as such this article will focus on this option.

Step #2: Get started with MaxMind DB-Reader!

As mentioned in the pre-flight check, Composer will be required in order to follow these steps. If you do not have Composer setup on the server please feel free to review our Composer series here: ‘What is Composer?’.

To acquire the necessary DB-Reader package you will want to start by changing directory so that you are in the root folder of your domain (for this example we will just assume this is `public_html`), then you will run the following command:

[public_html] $ composer require maxmind-db/reader:~1.0

Running this command will download the package files into the current folder, as described in our Composer series. This will create a vendor folder if this is the first time using Composer in this site/project.

Next you will require the actual MaxMind database files which contain the geolocation data. To get these files you will execute the following commands:

[public_html] $ funzip <(curl -L http://geolite.maxmind.com/download/geoip/database/GeoLite2-Country.mmdb.gz) > ./GeoLite2-Country.mmdb
[public_html] $ funzip <(curl -L http://geolite.maxmind.com/download/geoip/database/GeoLite2-City.mmdb.gz) > ./GeoLite2-City.mmdb

With the above commands executed you should now have the necessary components to do Geolocation using the DB-Reader plugin. All that’s left is to implement it in your code.

Step #3: Looking up your first IP

In order to ensure the geolocation features are working properly you may want to do a quick test. First we’ll confirm you have all the right pieces by running the following command:

$ ls -lah

You should see a file structure similar to this:

-rw-rw-r-- 1 someuser someuser 63 Aug 11 17:03 composer.json
-rw-rw-r-- 1 someuser someuser 2.4K Aug 11 17:03 composer.lock
-rw-rw-r-- 1 someuser someuser 73M Aug 11 17:04 GeoLite2-City.mmdb
-rw-rw-r-- 1 someuser someuser 19M Aug 11 17:04 GeoLite2-Country.mmdb
drwxrwxr-x 4 someuser someuser 4.0K Aug 11 17:03 vendor/

Now you are ready to do a quick test, you can do so by creating an index.php file with the following content:

<?php
require_once 'vendor/autoload.php';

use MaxMind\Db\Reader;
$ipAddress = '8.8.8.8';
$databaseFile = './GeoLite2-City.mmdb';

$reader = new Reader($databaseFile);

print_r($reader->get($ipAddress));

$reader->close();

This index file will simply do a quick test to ensure that the database file is being loaded, an IP can be checked, and the results are being provided. The test will be looking up the geographic information related to Google’s DNS server at 8.8.8.8.

Geo-location results for Google's 8.8.8.8 DNS server via MaxMind
Geo-location results for Google’s 8.8.8.8 DNS server via MaxMind

Having followed the directions correctly you should see output similar to the image above when loading the test index page.

How to Disable MySQL Strict Mode

MySQL’s, and MariaDB’s, strict mode controls how invalid or missing values in data changing queries are handled; this includes INSERT, UPDATE, and CREATE TABLE statements. With MySQL strict mode enabled, which is the default state, invalid or missing data may cause warnings or errors when attempting to process the query.

When strict mode is disabled the same query would have its invalid, or missing, values adjusted and would produce a simple warning. This may seem like the preferred result, however with strict mode disabled certain actions may cause unexpected results; for instance, when the value being inserted exceeds the maximum character limit it will be truncated to fit the limit.

There are various reasons why MySQL’s strict mode may need to be disabled, however the most common is when a server is running WHMCS — this is a requirement of that tool.

Pre-Flight Check

  • These instructions are intended specifically for disabling MySQL strict mode on a managed Liquid Web server with cPanel.
  • The server should be running either MySQL 5.6/5.7 or MariaDB 10.x
  • Command line and root level access via SSH will be necessary to follow this tutorial.

Step #1: Make Backups, Always!

Whenever modifying files on a server it’s always best practice to take some form of a backup beforehand. This ensures you have a way to revert changes if something goes awry; it’s also beneficial because it helps track when and what changes were made.

While logged into SSH with the root user, do the following:

cp -a /usr/my.cnf{,.strict.bak}
cp -a /etc/my.cnf{,.strict.bak}

The above command uses ‘BASH brace expansion’ in order to make a backup copy of the file in its original directory.

Step #2: Disable MySQL Strict Mode

Depending on the server and the current configurations you may need to edit one, or both, of the following files on the server. Generally, the relevant configuration lines are only in one of them, however, it could be in either one without causing issues; so generally it’s best to check both.

To edit the files, you will open the file with your favorite command line editor. In this example, we use ‘vim’.

vim /usr/my.cnf
vim /etc/my.cnf

In vim, you can press “a” or “i” to enter text insertion mode; pressing the escape key (Esc) on your keyboard returns you to command mode. For a refresher on editing files with vim, see our New User Tutorial: Overview of the Vim Text Editor.

Within each file above you will be looking for a line with the following content:

sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES

If you find a line similar to the above that is setting the `sql_mode` variable then you will need to replace it with the following line to disable MySQL strict mode.

sql_mode=""

Once this adjustment has been made, or you’ve confirmed the file does not need to be adjusted you will then save and close the file.

Step #3: Restart the MySQL Service

Finally, to make these changes effective you will need to restart the MySQL service as it will only read the configuration files when it initially loads up. In order to force MySQL to use the new configuration files you will do the following:

For CentOS 7 servers:
systemctl restart mysql

For CentOS 6 and prior:
/etc/init.d/mysql restart

After issuing this command on the server the MySQL service will be restarted and will load the changes made. If all the directions were followed and completed, then MySQL strict mode should now be disabled.

To verify that the process was completed properly you can run the following:

mysql -e "SELECT @@sql_mode;"

The output may look similar to the following:

+--------------------------------------------+
| @@sql_mode
+--------------------------------------------+
| NO_AUTO_CREATE_USER
+--------------------------------------------+

If you have any questions or are not comfortable making these changes yourself, please feel free to contact Heroic Support®.

How To Modify an Existing Email Account in Thunderbird

How to Set up Email in Thunderbird
I. How To Set Up a New Email Account in Thunderbird
II. How To Modify an Existing Email Account in Thunderbird
III. How To Subscribe to IMAP Folders in Thunderbird

Pre-Flight Check

  • These instructions are intended specifically for setting up an email account in Mozilla Thunderbird 38.3.0 on Mac OS X 10.11.1.
  • While the steps should be similar across platforms and operating systems, they may not necessarily apply to older versions of Thunderbird.
  • For help with general email account settings, see How to Set up Any Email Client.

You can edit an email account that already has been configured in Thunderbird, for example should you decide to switch between non-SSL and SSL settings or change the server’s connection port. You change the connection type between standard (non-SSL) and secure (SSL) by changing the hostname and port for the incoming and outgoing servers.

Note: You cannot edit an existing email account to switch its account type from POP3 to IMAP or vice versa. To change the account type, you must add a new account of the desired type (POP3 or IMAP). Adding a new account with a different connection type should not require you to delete the old one in most mail clients.

To avoid data loss, please use caution any time you change an email account’s connection type or delete an email account. Removing an email account from a mail client also will remove all messages associated with it on the device and, specifically in the case of POP accounts that are not configured to retain mail on the server, there may be no way to recover those messages. If you have any doubt or questions, please feel free to contact Heroic Support® for guidance.

Step #1: Edit Incoming Server Settings

  1. To edit the incoming server, select your email address in the left pane and then click on View settings for this account in the main window.
  2. In the account settings window, click on Server Settings to update the Server Name and Port.incomingedit
    • Server Name
      • SSL settings will use the server’s hostname (e.g., host.yourdomainname.com)
      • Standard non-SSL settings will use the domain name (yourdomainname.com or mail.yourdomainname.com).
    • Port
      • SSL settings will use Port 993 for IMAP and Port 995 for POP3.
      • Standard non-SSL settings will use Port 143 for IMAP and Port 110 for POP3.

Step #2: Edit Outgoing Server Settings

  1. To edit the outgoing server settings, click on Outgoing Server (SMTP) in the left pane, select your outgoing server and click the Edit button.editoutgoing
  2. You can edit the server name and port in the popup window.out2
    • Server Name
      • SSL settings will use the server’s hostname (e.g., host.yourdomainname.com)
      • Standard non-SSL settings will use the domain name (yourdomainname.com or mail.yourdomainname.com).
    • Port
      • SSL settings will use Port 465.
      • Standard non-SSL settings will use Port 587 (depending on your server configuration, you may be able to use Port 25 as well).
  3. Click on the OK button to save the outgoing server settings, then click on OK once more to exit the settings menu and begin using your email account with the new settings.

 

How To Set Up a New Email Account in Thunderbird

How to Set up Email in Thunderbird

Pre-Flight Check

  • These instructions are intended specifically for setting up an email account in Mozilla Thunderbird 38.3.0 on Mac OS X 10.11.1.
  • While the steps should be similar across platforms and operating systems, they may not necessarily apply to older versions of Thunderbird.
  • For help with general email account settings, see How to Set up Any Email Client.

Step #1: Create the AccountCreate a new account in Thunderbird

  1. From Thunderbird’s main screen, select Email under the Create a new account section, or use the main menu to pull down to File -> New -> Existing Mail Account.
  2. On the window that pops up, select Skip this and use my existing email to proceed to the Mail Account Setup screen.
  3. Here you will enter some basic information about the account:
    • mailacctsetup1sYour name should be your name as you want it to appear in emails that you send.
    • Email address should simply be the email address you’re setting up.
    • Password is the email account’s password.
  4. Select Continue. Thunderbird now will attempt to discover the settings for your account automatically. If autoconfigure is not successful, you will need to configure the account manually.

Step #2: Set Account Type

manualconfig

  1. Select your account type, IMAP or POP3. For its ability to keep email in sync across multiple devices (desktop, laptop, phones and tablets), IMAP generally is recommended.
  2. Now click on the Manual config button to expand the settings window and set your connection type.

Step #3: Set Connection Method

  1. Fill out the Account Information fields using the instructions below as a guide.
  2. Click Done to complete the setup process.
  3. If you’re using standard (non-SSL) connection settings or are using secure (SSL) connection settings and have an SSL certificate installed on your mailserver, that’s all you’ll need to do set up the account. If you’re using SSL connection settings and are using the server’s self-signed SSL certificate, you will have one more step to complete.

newmailaccntsetup

Standard (non-SSL) settings

  • Server hostname column: Enter your domain name (e.g., mail.yourdomainname.com or yourdomainname.com) on both the Incoming and Outgoing rows.
  • Port column:
    • Incoming: For an IMAP connection, select “143”; For POP3, select “110”.
    • Outgoing: Select “25” or “587”
  • SSL column: Select “STARTTLS” on both the Incoming and Outgoing rows.
  • Authentication: This should be set to “Normal password” on both the Incoming and Outgoing rows.
  • Username: Your full email address, not just the part before the “@” symbol, on both the Incoming and Outgoing rows.
Note: If you accidentally set the SSL fields to “None”, you will see a warning popup notifying you of the security risks associated with foregoing any form of encryption. You should click on the Change Settings button to go back and change both SSL fields to “STARTTLS”, or configure a secure (SSL) connection.

Secure (SSL) Settings

  • Server hostname column: Enter your server’s hostname (e.g., host.yourdomainname.com) on both the Incoming and Outgoing rows.
  • Port column:
    • Incoming: For an IMAP connection, select “993”; For POP3, select “995”.
    • Outgoing (SMTP): Select “465”.
  • SSL: This should be set to “SSL/TLS” for both the Incoming and Outgoing rows.
  • Authentication: This should be set to “Normal password” on both the Incoming and Outgoing rows.
  • Username: This is your full email address, not just the part before the “@” symbol, for both the Incoming and Outgoing rows.

 

Step #4: Security Certificate

  1. ssl1If your server has a self-signed (free) SSL certificate installed on the mailserver and you attempt to make a secure connection using Thunderbird, you should see a warning in a popup window such as the one on the right.
  2. If that is the case, you will need to click the Confirm Security Exception button to accept the certificate and complete the setup process.
  3. If you choose, you also may check the box to Permanently store this exception so that you don’t need to continue to accept the certificate each time Thunderbird connects to your server.
Note: A self-signed certificate uses the same level of encryption as a verified certificate, except that it is you who are verifying your server’s identity, rather than a third party. However, if you would prefer to use a third-party verified SSL certificate to cover core services (cPanel/WHM, POP3, IMAP, SMTP and FTP) on your server, you can find instructions for ordering and installing an SSL certificate at Install an SSL certificate on a Domain using cPanel, and you’ll find a guide to installing your certificate on email and other core server services at Installing Service SSLs in cPanel. Should you find that you need any assistance, please feel free to contact a Heroic Support® technician who can assist with obtaining and installing an SSL from the vendor of your choice.

 

How to Subscribe to IMAP Folders in Thunderbird

How to Set up Email in Thunderbird

Pre-Flight Check

  • These instructions are intended specifically for setting up an email account in Mozilla Thunderbird 38.3.0 on Mac OS X 10.11.1.
  • While the steps should be similar across platforms and operating systems, they may not necessarily apply to older versions of Thunderbird.
  • For help with general email account settings, see How to Set up Any Email Client.

When connecting to your email server using the IMAP protocol, you have the ability to choose the specific mail folders to which you wish to subscribe.

Step #1: Open IMAP Folder Subscriptions

  1. Right-click on your email account’s Inbox in Thunderbird and then select Subscribe from the menu list.
    Subscribe to IMAP folders in Thunderbird
  2. In the Folder List window, you will see a list of all the email folders in your account on the server. Folders to which you already are subscribed will appear with a check mark.

Step #2: Manage IMAP Folder Subscriptions

  1. You can manage your folder subscriptions by clicking on the folder name in the Folder List window and then using the Subscribe or Unsubscribe buttons on the right.
    Subscribe or unsubscribe from the Thunderbird Folder List
  2. Once you’ve finished making changes, click the OK button. It may take a few moments for the folder list to update in your Mail pane.
Note: When subscribing to filtered mail folders such as Spam or Junk, all the mail coming into those folders on the server also will be downloaded and synced to your selected local mail client as well. If you are using a metered Internet connection or have limited bandwidth, please be aware that the transfer of email does count toward your data usage. If you typically receive a large volume of such filtered mail, subscribing to spam and junk folders is not recommended. Please feel free to contact Heroic Support® if you need assistance filtering unwanted incoming mail.

How To Set Up a New Email Account on an iPhone or iPad in iOS 9

How to Set up Email on an iPhone or iPad in iOS 9
I. How To Set Up a New Email Account on an iPhone or iPad in iOS 9
II. How To Modify an Existing Email Account on an iPhone or iPad in iOS 9

Pre-Flight Check

  • These instructions are intended specifically for setting up POP3/IMAP email on an iPhone or iPad running iOS 9.
  • If these instructions don’t quite work for you, check-out our tutorial How to Set up Any Email Client.

Step #1: Launch Settings

If you have re-arranged your home screen and Settings is not readily visible, you may swipe right and begin typing “Settings” into Spotlight to launch the app.

Step #2: Add the Email Account

iosadd1In the Settings app, navigate to Mail, Contacts, Calendars, and then click on Add Account.

Step #3: Select the Account Type

On the Add Account screen, select the last option, Other.

iosadd2

Step #4: Configure General Account Settings

iosadd3Fill out the requested information on the New Account screen and tap the Next button in the top-right corner of the screen once complete:

  • Name should be your name as you want it to appear in emails that you send.
  • Email should be your full email address.
  • Password is the email account’s password.
  • Description is the name you want displayed for the account in your Mail app

Step #5: Configure Advanced Account Settings

iosadd4The information from the previous screen will be pre-filled here, but you will need to fill in the rest now. Please note that, despite what the empty fields may suggest, none of the fields here are optional.

  • Account Type
    • Tap on IMAP or POP in the top field to select the account type.
    • Generally, IMAP is recommended on mobile devices due to its ability to keep email in sync across multiple devices (desktop, laptop, phones and tablets).
  • Incoming Mail Server
    • If you are using non-SSL settings, the Host Name will be mail.yourdomainname.com.
    • If you are using SSL settings, the Host Name will need to be set to the server’s hostname (host.yourdomainname.com).
  • User Name is your full email address.
  • Password is the email account’s password.
  • Outgoing Mail Server
    • If you are using non-SSL settings, the Host Name will be mail.yourdomainname.com.
    • If you are using SSL settings, the Host Name will need to be set to the server’s hostname (host.yourdomainname.com).
  • User Name is your full email address.
  • Password is the email account’s password.

If you chose POP as the account type, tap Save; If you chose IMAP, tap Next.

Accept SSL Certificate if Needed

  • iosssl2If you elected to use a non-SSL (standard) connection (using mail.yourdomainname.com instead of the server’s host name), you should a “Cannot Connect Using SSL” Alert Notification, and you will need to tap Yes to proceed with the account setup.
  • If you chose to use a secure (SSL) connection and your server has a self-signed (free) SSL certificate installed on the mail server, you will see a “Not Trusted” Alert Notification. You will need to tap on Trust in the upper-right corner to continue.
Note: A self-signed certificate uses the same level of encryption as a verified certificate, except that it is you who are verifying your server’s identity, rather than a third party. However, if you would prefer to use a third-party verified SSL certificate to cover core services (cPanel/WHM, POP3, IMAP, SMTP and FTP) on your server, you can find instructions for ordering and installing an SSL certificate at Install an SSL certificate on a Domain using cPanel, and you’ll find a guide to installing your certificate on email and other core server services at Installing Service SSLs in cPanel. Should you find that you need any assistance, please feel free to contact a Heroic Support® technician who can assist with obtaining and installing an SSL from the vendor of your choice.

Step #6: Enable the Account

  1. Verify that the switch next to Mail is toggled on.
  2. Tap Save.
  3. You’re now ready to start using your email address with iOS 9.

 

How To Modify an Existing Email Account on an iPhone or iPad in iOS 9

How to Set up Email on an iPhone or iPad in iOS 9
I. How To Set Up a New Email Account on an iPhone or iPad in iOS 9
II. How To Modify an Existing Email Account on an iPhone or iPad in iOS 9

Pre-Flight Check

  • These instructions are intended specifically for setting up POP3/IMAP email on an iPhone or iPad running iOS 9.
  • If these instructions don’t quite work for you, check-out our tutorial How to Set up any Email Client.

If you’ve already set up your email account on your device and need to update the password, want to switch between non-SSL and SSL settings, or need to change the port settings, you can easily edit the account from within the Settings app.

Note: You cannot edit an existing email account to switch its account type from POP to IMAP or vice versa. To change the account type, you must add a new account of the desired type (POP or IMAP) per the Adding a new email account instructions above. Adding a new account with a different connection type should not require you to delete the old one in most mail clients.

To avoid data loss, please use caution any time you change an email account’s connection type or delete an email account. Removing an email account from a mail client also will remove all messages associated with it on the device and, specifically in the case of POP accounts that are not configured to retain mail on the server, there may be no way to recover those messages. If you have any doubt or questions, please do not hesitate to contact Heroic Support® for guidance.

Step #1: Launch Settings

If you have re-arranged your home screen and Settings is not readily visible, you may swipe right and begin typing “Settings” into the search field to launch the app.

Step #2: Open the Email Account

  1. In the Settings app, navigate to Mail, Contacts, Calendars
  2. Tap the account name to view the account.
    ioszedit1

Step #3: Open Account Settings

On the main screen for your email account, tap on the email address near the top of the screen next to Account to access the account’s settings. From there, you will be able to edit the incoming and outgoing server settings as well as update the account password and port information.

ioszedit2

Step #4: Edit Account Settings

A. Incoming Mail Server setup

You can change the account description, connection method, and update the password from the Account settings window.

ioszedit3

  • Description: The name displayed for the account in Mail.
  • Host Name: If you are using non-SSL settings, use mail.yourdomainname.com. If you are using SSL settings, use the server’s hostname (host.yourdomainname.com).
  • User Name is your full email address.
  • Password is the email account’s password.

B. Connection Type and Port Configuration

Tapping on Advanced from the Account panel will open the advanced menu, where you can switch between SSL and non-SSL settings and edit the incoming mail port if necessary.

ioszedit4

  • Use SSL: To use secure (SSL) settings the Use SSL switch should be toggled on. To use standard settings, the Use SSL switch should be toggled off.
  • Authentication: should be set to Password.
  • Server Port setting is dependent on your connection type:
    • The standard IMAP port is 143.
    • The secure IMAP port is 993.
    • The standard POP port is 110.
    • The secure POP port is 995.

C. Outgoing Mail Server setup

ioszedit5

Outgoing server settings are configured from the Account screen. Tap Account in the top-left corner to go back to it, and then tap the server name under Outgoing Mail Server to bring up the SMTP page.

On the mail server page, tap on the name of your mail server to access its settings.

ioszedit6

  • Host Name: If you are using standard (non-SSL) settings, Host Name will be mail.yourdomainname.com. If you are using secure (SSL settings), Host Name will be the server’s hostname (e.g., host.yourdomainname.com).
  • User Name is your full email address, not just the part before the “at” sign.
  • Password is the email account’s password.
  • Use SSL switch: If you are using SSL settings, Use SSL should be switched on. If you are using standard settings, Use SSL should be switched off.
  • Authentication should be set to Password.
  • Server Port should be set to 587.

 

How To Set up a New Email Account in OS X 10.11

How To Set up Email in OS X 10.11
I. How To Set up a New Email Account in OS X 10.11
II. How To Modify an Existing Email Account in OS X 10.11

Pre-Flight Check

Step #1: Create the Account

  1. Launch Mail by clicking on its icon in the dock. Under the Mail menu, select Add Account.
  2. On the Choose a Mail account provider screen, select the radio button next to Other Mail Account and click the Continue button.
    OSX 10.11 Add Account Screen
  3. On the Add a Mail Account screen, enter your name, the email address and the email account’s password.
    OSX 10.11 Add New Mail Account Screen

Step #2: Account Settings

  1. At this point, you should see an additional popup window with a place for you to add additional settings.
  2. You will need to ensure that all the fields are completed:OSX 10.11 Additional settings
    • Email Address is the full email address you’re setting up.
    • User Name also is the full email address.
    • Password is the email account’s password.
    • Account Type will be IMAP or POP, depending on your preference. For its ability to keep email in sync across multiple devices (desktop, laptop, phones and tablets), IMAP generally is recommended.
    • Incoming and Outgoing Mail Server
      • If you are using non-SSL settings, both the Incoming Mail Server and Outgoing Mail Server will be your domain name: mail.yourdomainname.com (or simply yourdomainname.com).
      • If you are using SSL settings, both the Incoming Mail Server and Outgoing Mail Server will need to be set to the server’s hostname (e.g., host.yourdomainname.com).

Step #3: Security Settings

  1. If you set up the email account with standard connection settings (mail.yourdomainname.com), or you set up the account with secure SSL settings and have an SSL certificate installed on your mailserver, you can skip this section and proceed to Step 4. However, if you’re using SSL settings (host.yourdomainname.com) and your server has a self-signed (free) SSL certificate installed on the mail server, you should see a popup notification about the server certificate:
    OSX 10.11 Self-signed SSL Certificate Notice
  2. If you receive this notification, you will need to click either the Continue button to accept the certificate and proceed, or the Show Certificate button to inspect it. Should you wish to permanently store the certificate and add it to the Keychain, you can check the Always trust box before selecting Continue. Depending on your security settings, choosing to permanently store the certificate could require you to enter your password to add it to the Keychain.
    OSX 10.11 Can't Verify Self-signed SSL Certificate
  3. Note: A self-signed certificate uses the same level of encryption as a verified certificate, except that it is you who are verifying your server’s identity, rather than a third party. However, if you would prefer to use a third-party verified SSL certificate to cover core services (cPanel/WHM, POP3, IMAP, SMTP and FTP) on your server, you can find instructions for ordering and installing an SSL certificate at Install an SSL certificate on a Domain using cPanel, and you’ll find a guide to installing your certificate on email and other core server services at Installing Service SSLs in cPanel. Should you find that you need any assistance, please feel free to contact a Heroic Support® technician who can assist with obtaining and installing an SSL from the vendor of your choice.

Step #4: Finishing Up

  1. Ensure that the box next to Mail is checked and then click on Done to complete the setup.
  2. You’re now ready to begin using your email account with Mail.

 

How To Modify an Existing Email Account in OS X 10.11

How To Set up Email in OS X 10.11
I. How To Set up a New Email Account in OS X 10.11
II. How To Modify an Existing Email Account in OS X 10.11

Pre-Flight Check

You can edit an email account that already has been configured in Mail, for example should you decide to switch between non-SSL and SSL settings or update the password.

Note: You cannot edit an existing email account to switch its account type from POP3 to IMAP or vice versa. To change the account type, you must add a new email account of the desired type (POP3 or IMAP). Adding a new account with a different connection type should not require you to delete the old one in most mail clients.

To avoid data loss, please use caution any time you change an email account’s connection type or delete an email account. Removing an email account from a mail client also will remove all messages associated with it on the device and, specifically in the case of POP accounts that are not configured to retain mail on the server, there may be no way to recover those messages. If you have any doubt or questions, please contact Heroic Support® for guidance.

Since any changes must be made on both the incoming and outgoing servers, updating the email account’s password or switching between non-SSL and SSL settings is not as simple as toggling a single setting, but the steps are easy to follow.

Step #1: Configure Incoming Server Settings

  1. You set the incoming mail server in the Internet Accounts preferences pane. To access it, select Accounts from the Mail menu.
  2. On the Internet Accounts preferences panel, select the name of your email account from the left pane to update the password or change the incoming server name or connection type.OSX 10.11 Incoming Mailserver
  3. Update the Password
    • To update the email account password, enter the new password into the Password field in the Internet Accounts preferences pane.
  4. Change the Incoming Server Name or Connection Type (SSL/non-SSL)
    • Click the Advanced button at the bottom right of the Internet Accounts preferences pane to edit the Hostname via a popup panel.
      • SSL settings will use the server’s hostname (e.g., host.yourdomainname.com)
      • Standard non-SSL settings will use the domain name (yourdomainname.com or mail.yourdomainname.com).
    • Once you have changed the Hostname, click OK.

Step #2: Configure Outgoing Server Settings

  1. Select Preferences from the Mail menu to open the Internet Accounts preferences pane, then click on the account in the left menu.
  2. On the Account Information tab, locate the Outgoing Mail Server (SMTP) row and select Edit SMTP Server List from the select menu.
    OSX 10.11 Outgoing Mailserver
  3. Change the Outgoing Server Name or Connection Type (SSL/non-SSL)
    OSX 10.11 Account Information

    • Click on your mail server’s name in the top pane to select it, then change the Server Name on the Account Information tab to the desired value.
      • SSL settings will use the server’s hostname (e.g., host.yourdomainname.com)
      • Standard non-SSL settings will use the domain name (yourdomainname.com or mail.yourdomainname.com).
    • Once you’ve changed Server Name to reflect the desired connection type, click on the Advanced tab to configure SSL settings.
      OSX 10.11 Advanced Account Settings

      • Port: This should remain 587 regardless of connection method.
      • Use SSL: If you are using secure (SSL) settings, ensure that the Use SSL box is checked. If you are using standard, non-SSL settings, Use SSL should be unchecked.
      • Authentication should be set to Password regardless of connection method.
      • Both the User Name (full email address) and Password fields should be filled out. You can update the email account password by entering the current password into the Password field.
  4. Your email account will start using the new settings as soon as you click the OK button.

 

How To Change the Root Password in WHM

The root password is the key to full control over your server, and it’s essential that it remains secure. At some point, nearly every server administrator will need to change the root password, either to revoke access to previously authorized individuals or due to an internal password policy. Additionally, the server’s root password should be changed any time a security breach is suspected.

If your server is running cPanel and you have access to WebHost Manager, changing the server’s root password is a matter of only a few clicks.

Once you’ve logged into WHM with the current root password, select Change Root Password from the list on the left, under Server Configuration.

Enter a Strong New Password

Once you’ve selected a new root password (you can use any combination of upper- and lower-case letters, numbers and special characters to increase the password strength), enter the new password twice, then click the Change Password button. That’s all there is to it; you now can close out of WHM and log back in with the new password.

Note: Any time you update the server’s root password, please also update our records in your Manage dashboard so that our Heroic Support® technicians can continue to proactively monitor your server. If you change the root password without updating our records, we won’t be able to automatically attempt to resolve any issues that occur.