How do I rename a domain name?

Summary

Details

Kerio Connect 7 or later

Detailed description is in our online manual.

Kerio MailServer 6.x

It is highly recommended to upgrade to Kerio Connect as this is supported in the product. This change is complex and Kerio Connect can take over of all actions required during the domain name change.

The following article will discuss the steps required to rename a domain name in the Kerio MailServer. This article assumes that the old domain name is called domain.old and the new domain name is domain.new.

It is recomended that you create a full backup before you apply any changes. You can make a backup using the Backup feature in Kerio MailServer, or by copying mailserver.cfg , users.cfg and the store directory. Please review the following section of our manual for instructions on creating a full backup.

Note: This process requires that you stop the MailServer for a period of time.

1. Login to the Administration Console and create the new domain.new in the Domains section. Set this new domain as the primary domain name.
2. Stop the Kerio MailServer.
3. Navigate to your store directory on the filesystem, then go into the mail directory. There you should see a list of all of your domain names. If you see a folder for domain.new please remove it.
4. Rename the domain.old folder to domain.new
5. Navigate to the directory that the Kerio MailServer is installed. Open the users.cfg file with a plain text editor. Using the replace feature of your text editor, replace each occurance of domain.old with domain.new
6. (Optional) If you are using the Archiving feature, you will need to update the acl.fld file in the Archive directory. Navigate to your archive directory and replace any instance of domain.old with domain.new in the acl.fld file.
7. (Optional) If you are using Mailing Lists, you will need to update these also. Open the mailserver.cfg file with a plain text editor. Search for the section MailingList then replace the domain name for each of your mailing lists with domain.new.You also have to rename\store\lists\<OLDdomain>\to\store\lists\<NEWdomain>\.
8. Now we need to update the permissions for the Public Folders. There are two possiblities, depending if you have a single set of Public Folders for all domains, or individual Public Folders for each domain:
   - Single Public Folder: Navigate to the mail/#public directory and in the acl.fld file replace all instances of domain.old with domain.new
   - Individual Public Folders: Do the same as above, but each domain folder will have an acl.fld file, so you need to modify that file in each of the #public folders.
9. Because of the complexity of changing the folder sharing and subscribing files, it is recommended that you instruct your users to re-share any folders they had shared and re-subscribe to any folders they were subscribed to.
   
10. Start the Kerio MailServer
11. Log into the Administration Console and you can now remove domain.old from the Domains section.