Migrating or moving the license from one system to another

Migrating or moving the license from one system to another

Moving to a new computer? For every Gearmage program, the basic recipe is the same: fully uninstall the program on the old system, then install it and re-activate your license on the new one. A few products have extra steps to carry your settings across — find yours below.

Why uninstall first? Each license covers a set number of installations. Once the program is running on the new system, make sure it's fully uninstalled from the old one.
Mail Attachment Downloader PRO
Client or Server — copy your settings folder
Gear Doc Converter
Uninstall, reinstall, optionally copy settings

Mail Attachment Downloader PRO Client or PRO Server

This is the simplest way. You don't need to update or otherwise touch the old system, and it works whichever version you're coming from. The new version migrates your settings the first time it starts.

Part 1 — On the old system

1
PRO Server only: uninstall the service using the program's Service tab.
Heads up: using services.msc will not fully uninstall the service.
2
Quit the program. Then zip up everything in the %AppData%\MAD folder (open it in Explorer) into a zip file. Keep the zip somewhere you can reach from the new system.
3
Fully uninstall the program from the Windows Control Panel.

Part 2 — On the new system

4
Install the latest version and build of the program — see instructions here. Use the download links that came with your license email.
5
Re-activate and validate the same license on the new system.
6
Quit the program.
7
Unzip the contents of the zip from step 2 into the same %AppData%\MAD folder on the new system.
8
Start the program. This should trigger the settings migration.
9
Re-authenticate each of your mail accounts, then run a manual Connect and Download to test that everything works.
You will very likely need to re-authenticate every account again on the new system (re-enter the password or sign in again). Do this before relying on scheduled downloads.
10
PRO Server only: install the service again from the Service tab.

Alternative: export and import your settings

Prefer to use the program's own Export/Import tab? This works too, but you'll need to update the old system first so both systems are on the same version and build.

Part 1 — On the old system

1
PRO Server only: uninstall the service using the program's Service tab.
Heads up: using services.msc will not fully uninstall the service.
2
RECOMMENDED
Update the old system to the latest build so both systems use the same version number and build — see instructions here. Then confirm everything works by running a manual Connect and Download.
Important if you're on version 3.2 or older: you must update first, because your settings need to be migrated to the current version. If you'd rather not update the old system, use the recommended method above instead.
On a newer version you can skip the update, but the exported settings version may then not match the version you import into. That can cause problems migrating your settings.
3
Export your settings to a .mdz file using the Export/Import tab. Keep this file somewhere you can reach from the new system.

On the old system, click Export settings.
4
Fully uninstall the program from the Windows Control Panel.

Part 2 — On the new system

5
Install the latest version and build of the program — see instructions here. Use the download links that came with your license email.
6
Re-activate and validate the same license on the new system.
7
Import your settings from the .mdz file you exported earlier.

On the new system, open the same tab and click Import settings.
Passwords are not exported or imported. You will very likely need to re-authenticate every account again (re-enter the password or sign in again) after importing.
PRO Server only: re-install the service (on the Service tab) after importing.
8
Quit the program and restart it. Then re-authenticate each of your mail accounts and run a manual Connect and Download to test that everything works.

Backing up settings

Detailed instructions are available here.

Manual settings copy
Settings are usually stored in %AppData%\MAD. Open it in Explorer — or in the folder you chose if you used command-line arguments to specify a different one.

This is the folder to zip up and copy in the recommended method.
Tip: settings belong to the Windows user who runs the program, so copy them into the %AppData% of the user you'll run it under on the new system. To find the folder, go to the Logs tab and click Settings Folder under Client. You can also save the whole folder as a zip from there.
Automatic backups
Daily backups of your settings are stored in %AppData%\MAD_BACKUP.

You can import from here too if your settings were ever corrupted.

Gear Doc Converter

Simply uninstall from the old system and re-install on the new system.

Manual settings copy (optional)
All settings are stored in %AppData%\GearDoc. Copy the contents of this folder to the new system and restart the program.