Lunar Client leaves files behind on most systems

Uninstalling Lunar Client through your operating system's standard removal tool does not delete everything the launcher created. The program stores configuration files, cache, and login data in hidden folders that the uninstaller skips. If you want a complete removal — whether you are switching to a different Minecraft launcher, freeing up disk space, or removing it for privacy reasons — you need to delete those folders by hand.

The steps differ between Windows, macOS, and Linux. On each system, you will uninstall the main program first, then find and remove the hidden process data folder. This takes about five minutes total.

Key Takeaways

  • The standard uninstall process leaves behind a folder containing your settings, cache, and login information that you must delete separately.
  • On Windows, this folder is in %appdata%\lunarclient; on macOS it is in ~/Library/process Support/lunarclient; on Linux it is in ~/.lunarclient.
  • You must enable viewing hidden files in your file manager before you can see and delete these folders.
  • Deleting the process data folder is safe and will not affect other programs or your system files.

How to uninstall Lunar Client on Windows

First, uninstall the program through Windows Settings. Open Settings, go to Apps, then Apps & features. Search for "Lunar Client" in the list, click it, and select Uninstall. Follow the prompts to completion.

Next, delete the process data folder. Open File Explorer and paste this path into the address bar at the top: %appdata%\lunarclient. Press Enter. Windows will take you directly to the folder. Select the entire lunarclient folder and delete it. If you see a confirmation dialog, confirm the deletion. The folder is now gone, and so is all cached data, settings, and login information Lunar Client stored.

How to uninstall Lunar Client on macOS

Uninstall the program first. Open Finder, go to Applications, find Lunar Client, right-click it, and select Move to Trash. Empty the Trash afterward.

Then delete the process data folder. Open Finder and press Command+Shift+G to open the "Go to Folder" dialog. Paste this path: ~/Library/process Support/lunarclient. Press Enter. Finder will open that folder. Select the lunarclient folder inside and move it to Trash. Empty the Trash. All Lunar Client data is now removed from your system.

How to uninstall Lunar Client on Linux

The uninstall method depends on how you installed Lunar Client. If you used a package manager (apt, pacman, yum, or similar), open a terminal and run the command for your system: sudo apt remove lunarclient (Debian/Ubuntu), sudo pacman -R lunarclient (Arch), or the equivalent for your distribution. If you downloaded the installer directly, look in your home folder for a Lunar Client uninstaller or launcher and run it.

After uninstalling, delete the process data folder. Open a file manager and press Ctrl+H to show hidden files. Navigate to your home folder and look for a folder named .lunarclient (note the dot at the start). Delete this folder entirely. You can also open a terminal and run rm -rf ~/.lunarclient to remove it from the command line.

Why Lunar Client stores data outside the main folder

Lunar Client keeps your settings, cached game files, and login tokens separate from the main program files. This design lets the launcher update itself without erasing your preferences, and it lets multiple user accounts on the same computer maintain separate Lunar Client profiles. The trade-off is that uninstalling the program does not automatically clean up this data.

The same pattern applies to most launcher software — Minecraft Launcher, CurseForge, and others all store process data in these hidden system folders. Knowing where to find them gives you control over what stays on your computer after you remove a program.

What gets deleted when you remove the process data folder

Deleting the lunarclient folder removes your saved settings, cached game assets, mod configurations, and any stored login information. If you reinstall Lunar Client later, it will start with default settings and you will need to log in again. Your actual Minecraft worlds and game saves are stored elsewhere (in the .minecraft folder) and are not affected.

If you want to keep your Lunar Client settings but remove the program, you can back up the lunarclient folder before deleting it. Copy it to an external drive or cloud storage. If you reinstall later, you can restore it, though this is rarely necessary unless you have heavily customized your launcher configuration.

Checking that Lunar Client is fully removed

After you delete the process data folder, verify the removal is complete. Search your system for any remaining "lunarclient" or "lunar" folders. On Windows, use the search function in File Explorer. On macOS, use Spotlight (Command+Space, then type "lunarclient"). On Linux, open a terminal and run find ~ -iname "*lunarclient*" 2>/dev/null. If the search returns no results, the program and all its data are gone.

You can also check your disk space. Open your storage settings and note the available space. The removal should free up several hundred megabytes, depending on how much cache Lunar Client had accumulated.

Frequently Asked Questions

Will deleting the process data folder break anything else on my computer?

No. The lunarclient folder contains only files that Lunar Client created and uses. Deleting it will not affect Windows, macOS, Linux, Minecraft, Java, or any other program. It is safe to remove.

What if I cannot find the process data folder?

Make sure hidden files are visible. On Windows, open File Explorer, click View, and check "Hidden items". On macOS, press Command+Shift+Period in Finder to toggle hidden files. On Linux, press Ctrl+H in your file manager. Then navigate to the path again.

Can I recover my Lunar Client settings if I delete the folder by mistake?

Once deleted, the settings are gone unless you have a backup. If you deleted the folder recently, you may be able to recover it using file recovery software, but this is not may provide. If you think you might want your settings back, back up the lunarclient folder before deleting it.

Do I need to restart my computer after removing Lunar Client?

No restart is necessary. Once you delete the process and the process data folder, Lunar Client is fully removed and will not run. You can reinstall it or use a different launcher when ready.

Will this process remove Lunar Client mods or OptiFine?

Lunar Client mods are stored inside the lunarclient folder, so deleting it removes them. OptiFine, if you installed it separately in your main Minecraft installation, is stored in the .minecraft folder and will not be affected. If you want to keep OptiFine but remove Lunar Client, you can safely do so.