How can we help?


Migrating on-premise atmail 7 to the atmail 8 cloud.

Jason -


I want to upgrade my atmail 7 system to the atmail 8 cloud


  • existing atmail 7 system
  • provisioned atmail 8 cloud account

Moving forward, we will assume you already have an atmail 8 cloud account set.  You can find a brief overview of setting this on online here:


atmail 7 EOL


The process for migrating from your existing atmail 7 solution to our atmail 8 cloud environment can be fairly simple and managed on your own, or we are available to manage this for you.  A detailed break down of the steps are as follows:

  1. Import your users into your atmail 8 cloud system. This can be done from the Account Manager in the admin section of your cloud account.  If you have more than a handful of users and do not want to import these into the system one at a time, the atmail cloud allows for the import of users with a CSV file. A sample of this is available from the import dialog of the Account Manager.
    1. A CSV file can be created by extracting the users information from the atmail 7 system directly. The fields required are:
      1. EmailAddress
      2. FirstName
      3. LastName
      4. Password (you will need the plain text version of the passwords to use the import utility from the Account Manager. If you don’t have passwords in plain text, assistance from the atmail support and operations team may be required))
  1. Migrate your email into the atmail 8 cloud. This can be managed on your own or with the assistance of the atmail support and operations staff.  There are a couple of methods we normally use for this, Both manage this by syncing the email over IMAP.
    1. IMAPSYNC – This is a freely available tool for syncing two IMAP accounts. You can find the details for this in our on premise documentation online here: While this document is geared towards the on premise installation, the theory and methodology are the same and will give you an understanding of the process.
    2. dsync – This is included as part of the inbuilt Dovecot suite of utilities and is very similar to the IMAPSYNC utility in theory. If you do not have the plain text passwords for your users OR if your users are using third party POP clients, you may need to consider using dsync for migrating the email. Please contact the atmail support and operations team for assistance with this.  For your knowledge, the documentation for dsync can be found online here:
  2. Migrating your aliases to the atmail cloud. Aliases can be added from the admin under the Services tab.  If you require assistance migrating a large number of aliases into the atmail 8 cloud, our support and operations staff can assist you with this.
  3. Migrate contacts and calendars. The atmail 7 and atmail 8 calendar and contact functions are all managed through the DAV services. Migration of this data could be managed client side or server side.

    1. Client side - End users can do this manually through the use of their third party clients (Outlook, Mac, Thunderbird, etc...), if they are using them.  The users would need to make sure they sync their contacts from their atmail 7 accounts to their third party client.  The users will then simply need to connect their clients to the new atmail 8 system and sync their contacts and calendars with their new accounts.

    2. Server side - It is possible to migrate the calendar and contact data directly through the DAV services. atmail has develoed it's own set of utilities to assist with this that loop through each user on the system, connecting to the atmail 7 DAV system, fetch the contacts or calendar data (as vcard or ics files) and then import these through the DAV services into the atmail 8 system. Similar to how the vdirsyncer utiltiis (also on github) work.


  4. Once your users are imported into the system and your email has been synced, we recommend running a thorough testing of the accounts on the atmail 8 cloud environment prior to making the switch to using the new atmail 8 cloud. You can contact the atmail support and operations team for guidelines on this testing if you require.
  5. Once you are satisfied with the new atmail 8 environment, you simply need to point your DNS to the new service.

This is meant to be a high level overview of the process of moving yourself into the atmail 8 cloud system from your existing atmail 7 on premise solution.  If you have any questions or concerns about any of these steps, please let us know and we are happy to assist you in  your move into your new cloud environment.

Have more questions? Submit a request


Contact our support team

+61 (7) 5357 6605