System Cleanup

It you have done testing of MASQ in the past, it is important to do a full System Cleanup to remove old MASQ core databases and config!

Quick System Cleanup

Windows

• Head to "Add or Remove Programs" menu in Windows, click on MASQ in the installed program list and click the "Uninstall" button

• The uninstaller may prompt you that MASQ is still running, and to click OK to stop process to complete uninstall. Click OK on this option

• Follow the cleanup script guide below here

You will need to end the background serviceMASQNode(named MASQDaemon or MASQNode) on your machine if this is still running after an uninstall.

MacOS

There is a specific MASQ Uninstaller tool that was created with v0.9.2 to assist users to system cleanup.

• Download the MASQ Uninstaller tool here

• Open the ZIP archive and move the app folder package named "MASQ Uninstaller" to your filesystem

• Double click on it and it should simply run as an app - there will be a Prompt that asks you to restart

• Click Yes to restart your computer

Linux

For Linux snap it's a single command: sudo snap remove masq

---

Full System Cleanup Manual Steps

All previous MASQ installers, directories and databases will need to be deleted. Ensure you follow the steps below to prepare your system before you install the latest MASQ software

Windows

You can use the Windows batch file to handle all of this is a few simple clicks below!

• Uninstall any previous version of MASQ from machine

• Remove the firewall exception for masqnode.exe (more just to keep things clean)

• Move any logs that need to be inspected or saved and delete node-data.db from

  C:\Windows\System32\config\systemprofile\AppData\Local\MASQ

  • NOTE: You will need to manually navigate to C:\Windows\System32\config\systemprofile\AppData\Local\MASQ\

    Pasting it the path in Explorer may not work the first time due to permissions

• Delete any Electron files in directory: C:\Users\<USER>\AppData\Local\electron

• Delete the cache and setting files in directory: C:\Users\<USER>\AppData\Roaming\MASQ

• Delete the cache and setting files in directory if present, from previous installers: C:\Users\<USER>\AppData\Local\MASQ

• Check your MASQ installation folder before doing any new installs, and ensure the masqnode.exe file has been removed. If not follow breaking changes instructions:

  • Open Task Manager

  • Navigate/Find to the Services tab

  • Locate 'MASQ Daemon' and right click it and select "Stop" service.

  • Then you can delete the MASQNode.exe file from the previous installation directory under your installation directory (in Windows this is default under 'Program Files')

You can also use the Windows batch file to handle all of this is a few simple clicks below!

A few Windows 10 users have reported that their logs and node-data.db file may appear in this filepath: C:\Windows\SysWOW64\config\systemprofile\AppData\Local\MASQ

MacOS

Linux Snap

Linux AppImage + MASQNode

---

Using Scripts to Clean Setup Files

You can utilize a batch file to quickly delete cache, logs and database files in between installing/uninstalling Beta versions.

Here are some suggested command scripts users can employ:

Windows

sc stop "MASQDaemon" && sc config "MASQDaemon" start=disabled
@RD /S /Q "C:\Windows\System32\config\systemprofile\AppData\Local\MASQ"
@RD /S /Q "C:\Users\%USERNAME%\AppData\Roaming\MASQ"
@RD /S /Q "C:\Users\%USERNAME%\AppData\Local\MASQ"
@RD /S /Q "C:\Program Files\MASQ"
@RD /S /Q "C:\Windows\SysWOW64\config\systemprofile\AppData\Local\MASQ"

You can also follow these steps to create a one-click batch file to run on Windows!

1. Create new text document in Notepad. Paste the above into it.

2. Save the file as a Batch (.bat) file.

3. Uninstall MASQ, using Windows 'Programs & Features' menu

4. Right click batch file and select 'Run as Administrator' to have it delete all the above folders, and remove MASQ Daemon service files

5. Reinstall MASQ.

MacOS/Linux