Horcrux Help

Chapter 2

Add an email account.

Horcrux walks you through the provider, connection, backup type, schedule, the Horcrux Library when needed, mailbox selection, and Backup Locations. This guide explains each choice before you make it.

Choose your email provider

Open Accounts, click Add Account at the bottom of the sidebar, then choose the provider for the address you want to back up.

Horcrux Add Account screen with Gmail, Microsoft 365, iCloud, and Other IMAP Account choicesHorcrux Add Account screen with Gmail, Microsoft 365, iCloud, and Other IMAP Account choices
Choose the provider that hosts the mailbox. Google Workspace accounts use the Gmail option.
ProviderConnection
Gmail or Google WorkspaceHorcrux opens Google sign-in in your browser.
Microsoft 365 or Outlook.comHorcrux opens Microsoft sign-in in your browser.
iCloud MailEnter an app-specific password from your Apple Account.
Other IMAPEnter the account details. Horcrux first tries to find the server settings automatically.

Connect and verify the account

For Google or Microsoft, finish authorization in the browser and return to Horcrux. For iCloud or another IMAP provider, enter the requested account details and click Connect.

Your credentials stay on your Mac

Horcrux stores saved account credentials in Apple Keychain. Your email is read directly from the provider and saved to the backup location you choose. It does not pass through Horcrux servers.

For Other IMAP, you can leave the hostname blank at first. If automatic discovery does not work, enter the IMAP hostname, port, and TLS setting supplied by your email provider.

Choose how Horcrux keeps saved mail

Email Archive is the default and the best starting point when you want long-term retention. Once Horcrux backs up a message, the archive keeps it even if you later delete it from the email account.

Horcrux Add Account screen showing Email Archive and Backup History choicesHorcrux Add Account screen showing Email Archive and Backup History choices
You can change the backup type later from Manage Account. Horcrux shows a review before removing old backup files.
  • Email Archive: keeps every backed-up message in one searchable collection, but does not preserve dated versions of the mailbox.
  • Backup History: keeps dated versions so you can browse or restore the mailbox as it looked on an earlier day.

Choose a schedule and storage

Choose how often the account should back up. Backup History creates at most one dated backup each day, so it offers Daily or slower schedules. Email Archive can run every few hours because it adds new mail without creating dated versions. During evaluation, backups run manually.

If no Horcrux Library has been selected yet, setup asks for it first. This is required working data for the app, not a saved-mail copy. Keep it on reliable internal storage when possible.

After mailbox review, choose at least one Backup Location for the account’s saved mail. The first location is a local folder and becomes Primary. Horcrux 5 can add more local, SFTP, or Amazon S3 locations. See the Backup Locations guide before planning a multi-location setup.

Plan for attachments

Choose storage with room to grow. An account with many large attachments can use considerably more space than its message count suggests.

Review the mailbox selection

Horcrux lists the mailboxes it found. Drafts, Trash, and Spam or Junk start unchecked when Horcrux can identify them. Leave the defaults unless you know you need those folders.

Horcrux Add Account screen showing included mailboxes and Drafts, Junk, and Trash skippedHorcrux Add Account screen showing included mailboxes and Drafts, Junk, and Trash skipped
Keep Include new mailboxes automatically selected if you want future folders included without another setup step.

Continue to Backup Locations, choose where the account should be saved, then click Add Account. Horcrux inspects every selected location before writing to it, including when you reuse an existing backup. Select the account and click Run Backup if you want to start immediately.

Troubleshooting account setup

Google or Microsoft sign-in did not return to Horcrux

Return to Horcrux and try again. Allow the browser to open Horcrux after authorization. If the account already appears in the sidebar, open Manage Account and choose Reconnect.

iCloud says the password is incorrect

Your normal Apple Account password does not work for this connection. Create an app-specific password in your Apple Account security settings and enter that password in Horcrux.

Horcrux could not find the IMAP server

Ask the provider for its IMAP hostname, port, encryption setting, and username format. Make sure IMAP access is enabled, then enter those details in the manual fields.