A System Administrator can detach and reattach a SmarterMail domain to move it between different SmarterMail instances or to refresh its connection to the server. This process allows you to manage domain placement without deleting the underlying data.
Important: Detaching a domain will temporarily make the domain inaccessible to users and will stop all mail flow for that specific domain until it is reattached.
Before you begin
You will need:
System Administrator access to the SmarterMail instance.
The specific domain name you intend to move.
Access to the destination SmarterMail instance (if moving between different servers).
Detaching a SmarterMail Domain
Log in to the SmarterMail administration console.
Navigate to Domains > Manage Domains.
Locate the domain you wish to move in the list.
Select the domain and click Detach.
Confirm the action when prompted.
Reattaching a SmarterMail Domain
Log in to the destination SmarterMail instance.
Navigate to Domains > Manage Domains.
Select the option to add or import a domain (the specific path may vary depending on whether you are moving the domain to a new server or a new instance on the same server).
Enter the domain name and the directory where the mail data is stored.
Select Attach or Import.
Confirm the action to complete the process.
Confirm the result
The domain will appear in the list of active domains on the target SmarterTail instance.
The domain status will show as active and ready to receive mail.
You can verify the connection by attempting to sign in to the webmail for that domain.
Limitations
Detaching a domain does not delete the domain's data; however, you must ensure the destination instance has sufficient resources to accommodate the domain.
During the period between detaching and reattaching, the domain will not process incoming mail.
If moving a domain between different physical servers, ensure the DNS records (MX, SPF, etc.) are updated to point to the new server's IP address.
