# Reinstalling Mail Studio

If you've run into problems, or if you wish to reinstall and fully reset Mail Studio, there are a few steps that you need to take.

# Resetting

To reset Mail Studio to a fresh state, you need to delete/rename the configuration folder:

  1. Close Mail Studio.
  2. Find the configuration directory:
    • For Windows: C:\Users\<yourname>\AppData\Roaming\mstudio
    • For macOS: ~/Library/Application Support/mstudio
    • For Linux: ~/.config/mstudio
  3. Rename it from mstudio to mstudio_backup
  4. (Optional) If you wish to preserve your custom components, copy mstudio_backup/userPackages to the mstudio folder. This will transfer your components to the new instance.
  5. Start Mail Studio again.

At this point, you will have a brand new copy of Mail Studio. In most cases this is enough to reset the app to a fresh state. But things like Windows updates can sometimes lead to breakage of the program files themselves, so if things still don't work correctly after the above steps, you will need to also uninstall the app, and install it again.

# Uninstalling

To uninstall Mail Studio completely from your system is just a couple of steps.

# Windows

Use Add/Remove programs and uninstall Mail Studio. After this you can delete the folder C:\Users\<yourname>\AppData\Roaming\mstudio if you wish to remove the stored configuration.

# macOS

Drop Mail Studio from your Applications folder to the Trash bin. After this you can delete the folder ~/Library/Application Support/mstudio if you wish to remove the stored configuration.

# Linux

Open the folder ~/.Mail Studio. There you should see a script called uninstall.sh. Run it like this:

bash uninstall.sh

This will remove the application launcher and icons. After this you can delete the folders ~/.Mail Studio and ~/.config/mstudio if you wish to remove the stored configuration.