> ## Documentation Index
> Fetch the complete documentation index at: https://help.noxity.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to migrate your email inbox

> Copy your existing mailbox into your Noxity inbox with the guided migration tool. Your old email stays where it is, nothing is deleted.

<div className="not-prose mb-8 pb-6 border-b border-gray-200 dark:border-gray-800">
  <div className="mb-3 text-sm text-gray-500 dark:text-gray-400">
    Updated: May 22, 2026
  </div>

  <div className="flex flex-wrap items-center gap-x-5 gap-y-3">
    <div className="flex items-center gap-3">
      <img src="https://mintcdn.com/noxity/7AGDPHJNWXOTggDq/images/team/matic.png?fit=max&auto=format&n=7AGDPHJNWXOTggDq&q=85&s=236856f5898caae2ec034701c8cb2290" alt="Matic Bončina" className="w-10 h-10 rounded-full object-cover" width="256" height="256" data-path="images/team/matic.png" />

      <div className="flex flex-col leading-tight">
        <span className="text-sm text-gray-900 dark:text-gray-100">
          By <strong className="font-semibold">Matic Bončina</strong>
        </span>

        <span className="text-sm text-gray-500 dark:text-gray-400">
          Founder
        </span>
      </div>
    </div>

    <div className="ml-auto">
      <span className="inline-flex items-center gap-1.5 text-[11px] tracking-wide uppercase font-semibold px-2.5 py-1 rounded-full bg-gray-200 text-gray-700 dark:bg-gray-800 dark:text-gray-300">
        <Icon icon="clock" size={14} iconType="regular" />

        Review pending
      </span>
    </div>
  </div>
</div>

This page walks you through copying your old mailbox into your Noxity inbox with our migration tool. Setting it up takes a few minutes; the copy then runs on its own, and how long it takes depends on how much mail you have.

You do the whole thing at [migrate.noxity.io ↗](https://migrate.noxity.io). There's no account to make and nothing to log into.

## Before you start

Have these ready:

* The **email address and password** for the mailbox you're moving from (your old provider).
* The **email address and password** for your **Noxity mailbox**, the one you're moving to. You set this password when you created the address in cPanel.
* An **app password**, if your old provider needs one. An app password is a one-off password you generate for apps that don't use your provider's normal sign-in. Gmail, Google Workspace, Microsoft 365, Outlook.com, Yahoo, and iCloud all work this way. You don't have to sort this out in advance, the tool shows you exactly how to make one at the moment it's needed.

<Note>
  Your old mailbox isn't changed or emptied. The tool copies your messages, it doesn't move them, so the originals stay exactly where they are.
</Note>

## Step by step

<Steps>
  <Step title="Open the migration tool">
    Go to [migrate.noxity.io ↗](https://migrate.noxity.io). The whole tool is a single page. Nothing to install, no login.

    <Frame caption="The migration tool at migrate.noxity.io">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/open-tool-light.png" alt="The Noxity migration tool start screen" className="block dark:hidden" />

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/open-tool-dark.png" alt="The Noxity migration tool start screen" className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Enter the mailbox you're moving from">
    Type the email address and password of your current mailbox. The tool recognises the common providers (Gmail, Google Workspace, Microsoft 365, Outlook.com, Yahoo, iCloud) and fills in the mail server for you. For a mailbox on your own domain it looks the server up automatically. Take a second to check the server it filled in looks right.

    If you're not sure you typed the password correctly, click the eye icon in the password box to reveal it.

    <Frame caption="Entering the mailbox you're moving from">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/source-mailbox-light.png" alt="Source mailbox fields with the provider detected" className="block dark:hidden" />

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/source-mailbox-dark.png" alt="Source mailbox fields with the provider detected" className="hidden dark:block" />
    </Frame>

    If your provider needs an app password, a window opens with the exact steps for that provider and a link to their own guide. Follow it, create the app password, then paste it into the password box in place of your normal password.

    <Frame caption="App password prompt for providers that require one">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/app-password-light.png" alt="App password instructions shown for the detected provider" className="block dark:hidden" />

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/app-password-dark.png" alt="App password instructions shown for the detected provider" className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Enter your Noxity mailbox">
    Now enter the mailbox you're moving to. The tool asks whether your new mailbox uses the same address and password as the old one. For a move to Noxity they're different, so pick the option for a different address and password, then type your Noxity email and its password.

    Check the Noxity mail server the tool fills in. If you ever need it spelled out, the [mail client helper](/tools/mailhelper) shows the exact server name for any Noxity address.

    <Frame caption="Entering your Noxity mailbox">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/destination-mailbox-light.png" alt="Destination mailbox fields for the Noxity address" className="block dark:hidden" />

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/destination-mailbox-dark.png" alt="Destination mailbox fields for the Noxity address" className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Confirm and start">
    You'll see a summary of both mailboxes: the one you're copying from and the one you're copying to. Check both lines are right, then start the migration.

    <Frame caption="Reviewing both mailboxes before the copy starts">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/confirm-light.png" alt="Confirmation screen showing source and destination" className="block dark:hidden" />

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/confirm-dark.png" alt="Confirmation screen showing source and destination" className="hidden dark:block" />
    </Frame>
  </Step>
</Steps>

## While it runs

Once it starts, the page shows how far along it is:

* a percentage complete,
* an estimate of the time left,
* which message it's on, shown as "message N of M".

<Frame caption="Live progress while the mailbox copies">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/progress-light.png" alt="Progress view with percentage, time left, and message count" className="block dark:hidden" />

  <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/how-to/migrations/email-inbox/progress-dark.png" alt="Progress view with percentage, time left, and message count" className="hidden dark:block" />
</Frame>

You can leave it running and come back later. Keep the tab open until it finishes.

Near the end you might see it handle **sync artifact messages**. That's a second pass that catches any mail which landed in your old mailbox while the migration was running, so nothing gets missed.

When it's done, you'll see a completion screen. Your mail is now in your Noxity inbox, in the same folders, with read and unread marks and dates kept as they were. To start reading it on your phone or computer, set the account up with the [mail client helper](/tools/mailhelper).

<Tip>
  Got new mail in your old inbox after the migration? Run the tool again with the same details. It copies only the new messages and skips everything already moved, so you won't end up with duplicates.
</Tip>

## If something goes wrong

<AccordionGroup>
  <Accordion title="It says you need an app password">
    Some providers (Gmail, Microsoft 365, Yahoo, iCloud, and others) block normal password sign-ins for tools like this. When that happens, the tool shows you the exact steps for your provider, with a link to their guide. Generate the app password there, then paste it into the password box in place of your usual password.
  </Accordion>

  <Accordion title="It won't migrate to that destination">
    The tool only copies mail into Noxity mailboxes. If you see this, check that the destination is your Noxity email address and that the destination server is your Noxity mail server, not your old provider's.
  </Accordion>

  <Accordion title="It asks for a hostname, not an IP address">
    You entered an IP address in a server box. Type the mail server's name instead, like `mail.yourdomain.com`. A hostname lets the connection be encrypted and checked; a bare IP address can't be verified, so the tool won't use it.
  </Accordion>

  <Accordion title="It can't sign in to your old mailbox">
    Usually the password. Click the eye icon to confirm what you typed. If your provider needs an app password, use that instead of your normal password.
  </Accordion>

  <Accordion title="The migration stopped partway through">
    Run it again with the same details. It picks up where it left off and skips anything already copied, so you won't get duplicates. To clear the details the tool remembered and begin fresh, use **Start over**.
  </Accordion>
</AccordionGroup>

## Need a hand?

<CardGroup cols={2}>
  <Card title="Open a ticket" icon="life-ring" href="https://members.noxity.io/submitticket.php">
    Best for anything that needs an account check or a config change on our end.
  </Card>

  <Card title="Live chat" icon="messages" href="https://noxity.io/contact">
    Faster for quick questions during business hours.
  </Card>
</CardGroup>

<div className="mt-8">
  <Accordion title="Sources" icon="book-bookmark">
    * [Mail client helper](/tools/mailhelper)
    * [Email accounts in cPanel](/web-hosting/cpanel/email-management/email-accounts)
    * [migrate.noxity.io ↗](https://migrate.noxity.io)
    * [imapsync ↗](https://imapsync.lamiral.info/)
  </Accordion>
</div>