Skip to main content

System Cleanup

warning

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
warning

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​

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!

warning

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

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:

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"
tip

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.