How to Fully Delete Lunar Client From Your Computer
Lunar Client is a popular Minecraft modpack launcher that installs itself deeply into your system — including game files, JVM runtimes, cached assets, and configuration data scattered across multiple directories. A standard uninstall often leaves most of that behind. If you want it completely gone, you need to go beyond the default removal process.
What a Standard Uninstall Actually Removes
On Windows, using Add or Remove Programs (or the built-in uninstaller) will remove the core application executable and its main program folder. On macOS, dragging the app to the Trash does roughly the same. But Lunar Client stores a significant amount of data outside those locations — user profiles, cached game versions, cosmetics data, installed mod configurations, and telemetry logs.
These leftover files don't just take up disk space. On some systems, they can interfere with a clean reinstall, cause authentication issues, or leave behind settings you specifically wanted to wipe.
Step-by-Step: Full Removal on Windows 🗑️
Step 1 — Run the official uninstaller
Go to Settings → Apps → Installed Apps, find Lunar Client, and uninstall it. Alternatively, use the uninstaller located in the installation directory (typically C:Program FilesLunar Client).
Step 2 — Delete the .lunarclient folder
This is the most important step most guides skip. Open File Explorer and navigate to:
This folder contains game instances, cached JREs, launcher settings, cosmetics, and mod configurations. Delete the entire folder. It can range from a few hundred MB to several GB depending on how long you've used the client.
Step 3 — Clear AppData remnants
Lunar Client may also write to:
- C:Users[YourUsername]AppDataRoaminglunarclient
- C:Users[YourUsername]AppDataLocallunarclient
To access these, type %appdata% and %localappdata% into the Windows search bar or Run dialog. Delete any Lunar Client folders you find there.
Step 4 — Remove registry entries (optional but thorough)
Open Registry Editor (regedit) and search for entries containing "lunarclient" or "Lunar Client" under:
- HKEY_CURRENT_USERSoftware
- HKEY_LOCAL_MACHINESoftware
Only do this if you're comfortable with the registry. Deleting the wrong key can cause unrelated system issues. When in doubt, skip this step — leftover registry entries from Lunar Client are generally harmless.
Step 5 — Empty the Recycle Bin
Confirm the deletion and free the disk space.
Full Removal on macOS
Step 1 — Drag the app to Trash
Move Lunar Client from your Applications folder to Trash.
Step 2 — Remove support files
Open Finder, press Cmd + Shift + G, and navigate to each of these locations:
- ~/Library/Application Support/lunarclient
- ~/Library/Caches/lunarclient
- ~/Library/Preferences/ — look for any .plist files referencing Lunar Client
- ~/.lunarclient — same as Windows, this hidden folder in your home directory is the main data store
Delete any Lunar Client folders or files found in each location.
Step 3 — Empty Trash
What's in the .lunarclient Folder (And Why It Matters)
| Subfolder | Contents | Typical Size |
|---|---|---|
| jre/ | Bundled Java runtimes | 200–600 MB |
| gameDir/ | Per-version game files and configs | Varies widely |
| textures/ | Cached cosmetics and cape data | 10–100 MB |
| offline/ | Locally cached launcher assets | 20–80 MB |
| logs/ | Client session logs | Small |
The jre/ and gameDir/ subfolders are typically the largest contributors. If storage is the main reason you're uninstalling, these are the folders doing the most damage.
Checking for Lingering Processes
Before or after deletion, make sure Lunar Client isn't still running in the background. On Windows, open Task Manager and look for any process named lunar, lunarclient, or JavaW that was launched by Lunar. On macOS, check Activity Monitor. Active processes can lock files and prevent full deletion.
What This Doesn't Remove
A full Lunar Client uninstall as described above does not touch:
- Your Minecraft installation (.minecraft folder) — Lunar Client and the official launcher store game data separately
- Any Microsoft or Mojang account credentials saved by Windows Credential Manager
- Files associated with other Minecraft launchers (MultiMC, Prism, etc.)
If you're also planning to remove Minecraft itself, that requires a separate process for the .minecraft directory.
Where Setup Varies Between Users 🖥️
How involved this process feels — and how much data it recovers — depends heavily on your situation. Someone who installed Lunar Client last week with default settings will find far less leftover data than someone who's been running it for a year across multiple Minecraft versions, with several JRE downloads and version-specific game directories accumulated over time.
On systems with strict user permissions, the AppData and registry steps may require administrator access or behave differently. On shared or managed machines, some of those directories may be in non-standard locations depending on how the OS was configured.
The steps above cover the standard layout for most personal Windows and macOS installations — but where your specific files actually ended up depends on your OS version, whether you customized install paths, and how Lunar Client was configured on your machine.