How can we help?

Watch this space: Upcoming Help Centre Migration


Migrate from atmail 7 to atmail 8 mail server

Stewart -

How can I migrate from my atmail 7 server to my atmail 8 mail server?


  • atmail 8 mail server
  • atmail 7 server + webmail

Migration requirement.


IMAPSYNC ( is an IMAP migration utility by Gilles Lamiral which is capable of transporting your IMAP messages from one server to another. This document details how to transport your atmail 7 messages to an atmail 8 mail server installation using IMAPSYNC


You will need to build a list of users from atmail 7 in the following CSV format. 

Email address, First name, Last name, Password


Email address, First name, Last name, Password,FirstName,LastName,changeme,FirstName,LastName,changeme,FirstName,LastName,changeme

MySQL Export

MariaDB [atmail7]> select Abook.Account,Abook.UserFirstName,Abook.UserLastName,Users.Password INTO OUTFILE '/tmp/users.csv' FIELDS TERMINATED BY ',' LINES TERMINATED BY '\n' from Abook INNER JOIN Users on Abook.Account=Users.Account where Abook.Global='1';


Log into your webadmin and go to Account Manager. Click the import users button and follow the onscreen prompts to upload your CSV and import your users. 


First, install IMAPSYNC. You can either purchase the full source, or grab earlier versions from Ubuntu/Debian repositories. Once done, generate a list of your users in this format:


Where [source-username] is the source IMAP username, and [destination-username] is the username for your destination IMAP server. Separate new entries with newlines, like so:,password,,password,password,,password,password,,password 

Save the file as migrate-users.csv. Then, in the same directory, execute this command: 

{ while IFS=',' read u1 p1 u2 p2; do
imapsync --host1 [source-hostname] --authmech1 PLAIN --user1 "$u1" --password1 "$p1" --prefix1 INBOX. --sep1 / \
--host2 [destination-hostname] --authmech2 PLAIN --user2 "$u2" --password2 "$p2" --prefix2 INBOX. --sep2 . ...
done ; } < migrate-users.csv

Replace [source-hostname] with the hostname/IP of the source server. Replace [destination-hostname] with the hostname/IP of the destination server.

Executing the above command will then import all emails to the destination accounts.

Please note, this article presumes that the namespace separator of host1 is "." and host2 is ".". 

--prefix1 INBOX/ --sep1 .
--prefix2 INBOX. --sep2 .

These are optional, but may be necessary as atmail strictly uses "." throughout its front end infrastructure. 

Note: When migrating, the order of messages in the inbox will be arranged/displayed by the date the message was last modified (Not necessarily the date the email was received).


Please Note:
Passwords used in the CSV files must be plaintext.

Manually Migrating Calendars: You can manually migrate your calendar from atmail 7 into the atmail suite by using Apple Calendar. Guide can be found here.



Contact our support team

+61 (7) 5357 6605